Docker Compose - apowerb by thaink2

Count about 15 minutes, most of it downloading the images (about 3 GB).

Requirements

Linux, macOS or Windows (WSL 2), linux/amd64 or linux/arm64
Docker Engine with Compose v2: docker compose version must answer
4 GB of free disk space
Ports 3000 and 8000 free

1. Download and configure

git clone https://github.com/apowerb/apowerb-hosting.git
cd apowerb-hosting
cp .env.example .env
./scripts/generate-secrets.sh

The script fills the database password, the encryption key and the service tokens with random values, and never overwrites a value already set. Keep .env safe: losing ENCRYPT_KEY makes every connected integration unreadable.

2. Name the first administrator

Open .env and set:

DEFAULT_SUPERADMIN_EMAIL=you@example.com

Whoever signs up with this address becomes an administrator, with their own password. Without it, a new installation has no administrator at all. Optional, a model shared by every agent (otherwise each agent needs its own API key):

DEFAULT_LLM_MODEL=<provider/model>
DEFAULT_LLM_API_KEY=<your key>

3. Start

docker compose -f docker-compose/docker-compose.yml --env-file .env up -d

Always name the file. The docker-compose.yml at the root of the repository is the Hostman file: it has no PostgreSQL and stops on set DB_HOST.

docker compose -f docker-compose/docker-compose.yml --env-file .env ps
curl -s http://localhost:8000/health
./scripts/check-deployment.sh http://localhost:3000

Expected: three services running (postgres healthy), {"status":"ok"}, and every check ok. Then open http://localhost:3000 and sign up with the administrator e-mail from step 2. For HTTPS on a server, continue with Single VM / HTTPS.

Everyday commands

Run from the apowerb-hosting folder.

Task	Command
Follow the API logs	`docker compose -f docker-compose/docker-compose.yml --env-file .env logs -f apowerb`
Stop, keep the data	`docker compose -f docker-compose/docker-compose.yml --env-file .env down`
Update to the latest tested pair	`git pull`, then the step 3 command again
Back up the database	`docker compose -f docker-compose/docker-compose.yml --env-file .env exec -T postgres sh -c 'pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB"' > backup.sql`
Uninstall and erase all data	`docker compose -f docker-compose/docker-compose.yml --env-file .env down -v`

The images are pinned to an API and interface pair tested together. To change versions by hand, set APOWERB_BACKEND_TAG and APOWERB_FRONTEND_TAG in .env, always both: each one caps the other.

Optional services

Each one needs two lines in .env, then the step 3 command again. Profiles combine with a comma: COMPOSE_PROFILES=pulse,etl.

Service	Lines to add in `.env`
Logs and agent traces	`COMPOSE_PROFILES=pulse` and `OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318`
Scheduled agent runs	`COMPOSE_PROFILES=etl` and `ORCHESTRATOR=th2etl`
Forecasting	`COMPOSE_PROFILES=forecast` and `TH2FORECAST_URL=http://th2forecast:8000`

Troubleshooting

Symptom	Fix
`port is already allocated` on 3000 or 8000	Prefix the step 3 command with `FRONT_PORT=3010 TH2AGENT_PORT=8010`
`set DB_HOST` at start	You ran the root file: add `-f docker-compose/docker-compose.yml`
No model in the agent list	Add a key on the agent, or set both `DEFAULT_LLM_MODEL` and `DEFAULT_LLM_API_KEY`, then restart
Signed up but not administrator	`DEFAULT_SUPERADMIN_EMAIL` was empty at sign-up: set it, then restart the stack

Images

The compose file pulls published images from Docker Hub, nothing is built: apowerb/apowerb (API) and apowerb/apowerb-ui (interface). The full end-to-end test, account creation and an agent run included, is in docker-compose/TESTING.md.

​Requirements

​1. Download and configure

​2. Name the first administrator

​3. Start

​4. Check and sign up

​Everyday commands

​Optional services

​Troubleshooting

​Images

Requirements

1. Download and configure

2. Name the first administrator

3. Start

4. Check and sign up

Everyday commands

Optional services

Troubleshooting

Images