Quick Start¶

This guide will help you get AzharStore up and running quickly using Docker Compose.

Prerequisites¶

Docker and Docker Compose installed
Git (for cloning the repository)

1. Clone the Repository¶

git clone <repository-url>
cd az-main

2. Configure Environment Variables¶

cp .env.example .env

Edit .env with your configuration. At minimum, set:

DATABASE_URL=postgresql://postgres:postgres@localhost:5432/medusa
REDIS_URL=redis://localhost:6379
JWT_SECRET=your-jwt-secret
COOKIE_SECRET=your-cookie-secret
ADMIN_EMAIL=admin@azhar.store
ADMIN_PASSWORD=your-admin-password

3. Start Services¶

docker compose up -d

This starts: - PostgreSQL on port 5432 - Redis on port 6379 - Medusa backend on port 9000 - Store frontend on port 3000

4. Run Database Migrations¶

docker compose exec medusa npx medusa db:migrate

5. Seed Admin User¶

docker compose exec medusa npx ts-node scripts/seed-admin.ts

6. Access the Application¶

Store Frontend: http://localhost:3000
Admin Dashboard: http://localhost:9000/app

Next Steps¶

Read the Configuration Guide for detailed setup options
Explore the Architecture Overview
Check the API Documentation

Troubleshooting¶

If you encounter issues:

Check service status: docker compose ps
View logs: docker compose logs -f
See the Troubleshooting Guide