System Requirements
Aurelia Hub is a Laravel-based web application. To run it, you need:
Server Requirements
- PHP 8.2 or higher
- MySQL 8.0+ or MariaDB 10.6+
- Composer 2.x (PHP dependency manager)
- Node.js 18+ and npm (for frontend assets)
- Web Server: Nginx (recommended) or Apache
Required PHP Extensions
- BCMath, Ctype, cURL, DOM, Fileinfo
- GD or Imagick (for image processing)
- JSON, Mbstring, OpenSSL
- PDO (with MySQL driver)
- Tokenizer, XML, Zip
Recommended Server Specs
- CPU: 2+ cores
- RAM: 2 GB minimum, 4 GB recommended
- Storage: 10 GB minimum (more for media/images)
Installation
Step 1: Clone the Repository
git clone https://github.com/your-org/aurelia-hub.git
cd aurelia-hub
Step 2: Install PHP Dependencies
composer install --optimize-autoloader --no-dev
Step 3: Install Frontend Dependencies
npm install
npm run build
Step 4: Configure Environment
cp .env.example .env
php artisan key:generate
Edit .env and configure your database connection:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=aurelia_hub
DB_USERNAME=your_username
DB_PASSWORD=your_password
Step 5: Run Migrations and Seeders
php artisan migrate --seed
This creates all database tables and populates them with default data including default user account, customer categories, interaction types, and appointment types.
Step 6: Link Storage
php artisan storage:link
Step 7: Configure File Permissions
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache
Step 8: Set Up Queue Worker (Optional but Recommended)
php artisan queue:work --daemon
Step 9: Configure Web Server
Point your web server document root to the public/ directory.
Step 10: Access the Application
Navigate to your configured domain. Log in with the default credentials created during seeding, then change your password immediately.
Updating
git pull origin main
composer install --optimize-autoloader --no-dev
npm install && npm run build
php artisan migrate
php artisan cache:clear
php artisan config:clear
php artisan view:clear