Skip to content

Installation

This guide covers different installation methods for AzharStore.

The easiest way to run AzharStore is using Docker Compose.

Prerequisites

  • Docker 20.10+
  • Docker Compose 2.0+

Steps

  1. Clone the repository: 

    git clone <repository-url>
cd az-main

  2. Configure environment variables: 

    cp .env.example .env
# Edit .env with your values

  3. Start services: 

    docker compose up -d

  4. Run migrations: 

    docker compose exec medusa npx medusa db:migrate

  5. Seed admin user: 

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

Local Development

For local development without Docker.

Prerequisites

  • Node.js >= 20
  • PostgreSQL 16
  • Redis 7

Steps

  1. Clone the repository: 

    git clone <repository-url>
cd az-main/backend

  2. Install dependencies: 

    npm install

  3. Configure environment variables: 

    cp .env.example .env
# Edit .env with your values

  4. Run migrations: 

    npx medusa db:migrate

  5. Seed admin user: 

    npx ts-node scripts/seed-admin.ts

  6. Start development server: 

    npm run dev

Production Deployment

For production deployment, see the Infrastructure Guide.

Verification

After installation, verify:

  1. Services are running: 

    docker compose ps

  2. Backend is accessible: 

    curl http://localhost:9000/health

  3. Database is connected: 

    docker compose exec postgres pg_isready -U postgres

  4. Redis is connected: 

    docker compose exec redis redis-cli ping

Next Steps