Installation of Ragnos

This guide describes how to install Ragnos Framework from a distributed ZIP file.

Server Requirements

Ragnos is based on CodeIgniter 4, so it shares its minimum requirements:

  • PHP: Version 7.4 or higher (PHP 8.1+ recommended).
  • PHP Extensions:
  • intl
  • mbstring
  • json
  • mysqlnd (if using MySQL/MariaDB)
  • curl
  • gd (optional, for image manipulation)
  • Database: MySQL (5.1+) or MariaDB.

Installation Steps

1. Download and Extraction

  1. Download the .zip file with the latest version of Ragnos.
  2. Extract the content into your web server directory (e.g., c:\laragon\www\my-project or /var/www/html/my-project).
  3. Verify that the vendor folder exists and contains dependencies. Ragnos already includes all necessary libraries.

2. Environment Configuration

  1. Locate the env file in the project root.
  2. Rename or copy it to .env.
  3. Open the .env file and adjust the following variables:

Watch the dot

Make sure the file is named exactly .env (with the dot at the beginning) and not just env.

Environment:

CI_ENVIRONMENT = development

Base URL:

app.baseURL = 'http://localhost/my-project/'

Database: Uncomment and configure your database credentials:

database.default.hostname = localhost
database.default.database = your_db_name
database.default.username = your_user
database.default.password = your_password
database.default.DBDriver = MySQLi

3. Import Database

Ragnos requires certain base tables to function (users, sessions, permissions).

  1. Create an empty database in your manager (phpMyAdmin, HeidiSQL, etc.).
  2. Import the SQL files located in the sampledatabase/ folder:
  3. Run ragnos_mariadb.sql first (or the main dump containing the base structure).
  4. Run ci_sessions.sql for the sessions table.

4. Verify Permissions

Ensure that the writable/ folder and its subfolders have write permissions by the web server.

5. Run

Access your browser at the configured URL (e.g., http://localhost/my-project/public or simply http://my-project.test if using Laragon).

You should see the login screen.

6. Access Credentials (Demo)

To access the demo system for the first time, use the following credentials:

  • User: admin
  • Password: ok