Manual Installation

Manual Installation

If you prefer to run without Docker, follow these steps for a traditional server setup.

Prerequisites

Ensure PHP 8.4, Nginx, PostgreSQL 16+, Redis, and Node.js 20+ are installed and running.

Step 1: Clone and Configure

git clone https://github.com/your-org/ecommerce-orchestration.git
cd ecommerce-orchestration
cp .env.example .env

Step 2: Install PHP Dependencies

composer install --no-dev --optimize-autoloader

Step 3: Generate Application Key

php artisan key:generate

Step 4: Configure .env

Update your .env file:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=ecommerce_orchestration
DB_USERNAME=your_user
DB_PASSWORD=your_password

REDIS_HOST=127.0.0.1
REDIS_PORT=6379

QUEUE_CONNECTION=redis
SESSION_DRIVER=redis
CACHE_DRIVER=redis

Step 5: Run Migrations and Seed

php artisan migrate --seed

Step 6: Build Frontend Assets

npm install
npm run build

Step 7: Configure Nginx

Point your Nginx server root to the public/ directory and configure a standard Laravel try_files rewrite rule.

Step 8: Start the Queue Worker

php artisan horizon

Configure Supervisor or systemd to keep Horizon running in production.