Skip to content

Installation

Changemaker Lite runs as a set of Docker containers orchestrated by Docker Compose.

Prerequisites

  • Docker 24+ and Docker Compose v2
  • OpenSSL (for secret generation)
  • A Linux server (Ubuntu 22.04+ recommended) or macOS for development
  • At least 2 GB RAM and 10 GB disk space
  • A domain name (optional, but recommended for production)

Quick Start

# Clone the repository
git clone https://gitea.bnkops.com/admin/changemaker.lite
cd changemaker.lite
git checkout v2

# Run the configuration wizard
bash config.sh

# Start core services
docker compose up -d v2-postgres redis api admin

# Run database migrations and seed
docker compose exec api npx prisma migrate deploy
docker compose exec api npx prisma db seed

Open http://localhost:3000 and sign in with the admin credentials you configured.

Configuration Wizard

The config.sh wizard walks you through domain setup, admin credentials, secret generation, SMTP config, feature flags, and Pangolin tunnel setup. After completion you'll have a fully populated .env with no placeholder passwords.

Manual Setup

If you prefer to configure by hand, copy .env.example to .env and set the required values. See Environment Variables for every option.

Next Steps