Installation with Docker

Installation with Docker

Docker is the recommended way to install and run the platform. It bundles all services (PHP, Nginx, PostgreSQL, Redis) into isolated containers.

Step 1: Clone the Repository

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

Step 2: Configure the Docker Environment

cd docker
cp .env.example .env

Edit docker/.env to set your passwords, ports, and profiles:

COMPOSE_FILE=docker-compose.yml:docker-compose.dev.yml
COMPOSE_PROFILES=dev,workers,postgres,redis
DOCKER_BUILD_MODE=dev

Step 3: Configure Laravel Environment

cp .env.example .env

Update your .env file with database and Redis connection details matching your docker/.env.

Step 4: Build and Start Containers

docker compose up -d --build

Step 5: Install Dependencies and Migrate

docker compose exec app composer install
docker compose exec app php artisan key:generate
docker compose exec app php artisan migrate --seed

Step 6: Build Frontend Assets

npm install
npm run build

Step 7: Access the Application

• Application: http://localhost:8084
• Admin Panel: http://localhost:8084/admin
• Mailpit (dev email): http://localhost:8026

Default Admin Credentials

After seeding, log in with the admin account created by the DatabaseSeeder. Change credentials immediately after first login.