Installation

Installation

This is a quick-start guide. For the complete production setup (nginx, Redis, Supervisor, SSL) see DEPLOYMENT.md.

Requirements

• PHP 8.3+ with pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, fileinfo, bcmath
• MySQL 8.0 / MariaDB 10.6+
• Redis 6+
• Composer 2.x, Node.js 20+
• A web server (nginx or Apache)

Steps

1. Get the code — download a release ZIP and extract it, or clone the repository.

2. Install dependencies

   composer install --no-dev --optimize-autoloader
   npm ci && npm run build

3. Configure the environment

   cp .env.example .env
   php artisan key:generate

   Edit .env — set APP_URL, database credentials, Redis, and mail.

4. Point your web server at the public/ directory.

5. Run the installer — open https://your-domain.com/install and follow the wizard: requirements check, database, admin account, site settings, finish.

Once installed, the admin panel is at /admin.

Background services

For real-time features and queued jobs to work, keep these running (see DEPLOYMENT.md):

• php artisan horizon — queue workers
• php artisan reverb:start — websockets
• php artisan schedule:run — every minute via cron