Use this page to start a self-hosted OpenTaco stack with the Docker Compose assets in self-hosting/docker-compose.
Prerequisites
Before starting services, set the required environment variables described in Configuration.
At minimum, copy the service env files used by compose and populate them with the necessary values:
cp self-hosting/docker-compose/orchestrator.env.example self-hosting/docker-compose/orchestrator.env
cp self-hosting/docker-compose/drift.env.example self-hosting/docker-compose/drift.env
cp self-hosting/docker-compose/sidecar.env.example self-hosting/docker-compose/sidecar.env
cp self-hosting/docker-compose/ui.env.example self-hosting/docker-compose/ui.env
Start the stack with Make targets
From self-hosting/docker-compose/, use the Makefile targets:
# start only shared platform services (databases/object storage)
make platform-up
# start only OpenTaco application services
# (only when providing external databases/object storage)
make opentaco-up
# start everything
make all-up
Common lifecycle targets
PROFILE=all is the Makefile default.
make ps
# stream service logs
make logs
# restart services
make restart
# stop and remove services
make down
# rebuild images and start services
make up-build
# recreate services without rebuilding images
make recreate
# rebuild images and force recreate services
make rebuild
Host port forwarding
The Compose stack exposes these host ports for local access and hybrid development:
Verify current values in self-hosting/docker-compose/docker-compose.yml, especially if you customize the stack.
| Service | Host port | Container port |
|---|
orchestrator | 3000 | 3000 |
drift | 3001 | 3000 |
statesman | 8080 | 8080 |
token-service | 8081 | 8081 |
ui | 3030 | 3030 |
sidecar | 9100 | 9100 |
postgres-orchestrator | 5432 | 5432 |
postgres-statesman | 5433 | 5432 |
postgres-token-service | 5434 | 5432 |
minio | 9000 | 9000 |
minio console | 9001 | 9001 |
