Self-Hosting

You can run OpenToggl with Docker Compose.

Quick start

mkdir -p opentoggl-self-hosted
cd opentoggl-self-hosted

wget -O docker-compose.yml \
  https://raw.githubusercontent.com/CorrectRoadH/opentoggl/main/docker-compose.yml

docker compose up -d
docker compose ps

This starts:

• opentoggl
• postgres
• redis

Then check that it is ready:

curl -fsS http://localhost:8080/healthz
curl -fsS http://localhost:8080/readyz
curl -fsSI http://localhost:8080/

If those commands pass, the instance is up.

Notes

• Default app URL: http://localhost:8080
• If port 8080, 5432, or 6379 is already in use, override the compose env values before startup
• The container applies schema state automatically during startup

Where to start

Smoke verification

Minimum smoke verification is intentionally small and explicit:

curl -fsS http://localhost:8080/healthz
curl -fsS http://localhost:8080/readyz
curl -fsSI http://localhost:8080/

If these checks fail, the self-hosted baseline is not considered ready.