Installation Guide
Installation Overview
This installation guide explains how to set up and configure the RDA System (Laravel-based Application) on local or production servers.
The system follows a modular Laravel architecture with role-based access control, workflow automation, payment integration, and document processing system.
⚠️ Recommended for developers familiar with Laravel, Composer, and server configuration.
Server Requirements
Ensure your server meets the minimum requirements before installation.
  • PHP >= 8.1
  • Laravel 10 or higher
  • MySQL / MariaDB
  • Composer (Latest Version)
  • Node.js & NPM
  • Apache / Nginx Server
Required PHP Extensions:
  • BCMath
  • Ctype
  • Fileinfo
  • JSON
  • Mbstring
  • OpenSSL
  • PDO
  • Tokenizer
  • XML
Step 1: Project Setup
Start by cloning or uploading the project into your server directory.
Clone Project: 
git clone https://github.com/Tarikulat/rda-core.git
Install Dependencies: 
composer install
npm install
npm run build
💡 Make sure Composer and Node.js are installed globally before running commands.
Step 2: Environment Configuration
Create Environment File: 
cp .env.example .env
Generate Application Key: 
php artisan key:generate
Database Configuration: 
DB_DATABASE=your_db_name
DB_USERNAME=root
DB_PASSWORD=your_password
Step 3: Database Setup
Create a new database and configure it with Laravel migration system.
  • Create database in phpMyAdmin / cPanel
  • Update credentials in .env file
Run Migrations: 
php artisan migrate
Run Seeders (Optional): 
php artisan db:seed
⚠️ Seeder will create default roles, admin user, and system configuration.
Step 4: Storage & Permissions
Create Storage Link: 
php artisan storage:link
Set Permissions: 
chmod -R 775 storage
chmod -R 775 bootstrap/cache
💡 Proper permissions are required for file upload, logs, and caching system.
Step 5: System Installation Wizard
After setup, open your application in browser to complete installation. 
http://your-domain.com
  • Create Admin Account
  • Configure System Settings
  • Enable Payment & SMS APIs
  • Complete Installation
Pre-Production Configuration
  • Set timezone in .env (APP_TIMEZONE)
  • Configure SMTP mail settings
  • Setup SMS gateway API
  • Configure SSLCommerz payment gateway
  • Enable queue worker (if needed)
Installation Complete
System successfully installed and ready for production use.
  • Login as Admin
  • Create roles & permissions
  • Add officers & departments
  • Start application workflow processing