Skip to content

Installation & Setup

This guide covers setting up Coalition Builder for development and production.

Quick Start

Prerequisites:

  • Docker and Docker Compose
# Clone the repository
git clone https://github.com/lhadjchikh/coalition-builder.git
cd coalition-builder

# For production/CI (optimized builds)
docker compose up -d

# For development (live code reload)
docker compose -f docker compose.yml -f docker compose.dev.yml up -d

# Create test data
docker compose exec api python scripts/create_test_data.py

# Create admin user
docker compose exec api python manage.py createsuperuser

Access Points:

  • Frontend (SSR): http://localhost:3000
  • API: http://localhost:8000/api/
  • Admin: http://localhost:8000/admin/

Option 2: Manual Setup

Prerequisites:

  • Python 3.13+
  • Node.js 22+
  • PostgreSQL 16+ with PostGIS extension

  • Redis (for caching)

  • Clone and setup backend:

git clone https://github.com/lhadjchikh/coalition-builder.git
cd coalition-builder/backend
poetry install
  1. Configure environment:
cp ../.env.example .env
# Edit .env with your database credentials
  1. Setup database:
poetry run python manage.py migrate
poetry run python manage.py createsuperuser
  1. Start backend:
poetry run python manage.py runserver
  1. Setup frontend: 
    cd ../frontend
npm install
npm run dev

Production Deployment

For production deployment options, see:

Configuration

All configuration is handled through environment variables. See the Configuration Reference for details.

Next Steps