Ubuntu production installation

Start a one-host Forge Control Plane with the repository’s supplied Compose configuration.

Repository-validated operator guidance View source ↗

#Before you run it

Use Ubuntu 22.04 or 24.04, a new directory owned by the deploy user, and a real secret file. The installer supports Ubuntu and Debian, but these commands keep each configuration decision visible.

Protect infra/.env

It contains database credentials, API secrets, master keys, and a Beacon token. Do not commit it or copy a development file to production.

#Install and configure

From the repository root

git clone https://github.com/ryzenate1/forge-control-plane.git
cd forge-control-plane
cp infra/.env.example infra/.env
chmod 600 infra/.env
# edit infra/.env and set every required secret and public URL
./scripts/install.sh

#Compose-first alternative

Validate then start

cd infra
docker compose -f compose.yml -f compose.production.yml --env-file .env config --quiet
docker compose -f compose.yml -f compose.production.yml --env-file .env up -d --build
docker compose -f compose.yml -f compose.production.yml --env-file .env ps

#Verify

Repository health script

./scripts/healthcheck.sh
# or inspect only the control-plane stack
cd infra && docker compose -f compose.yml -f compose.production.yml --env-file .env logs --tail 150 api web postgres redis