Docker Setup

Recommended CLI-managed Docker workflows for self-host and production deployments.

by @saifyxpro

Recommended workflow

For most operators, the recommended Docker path is the published CLI.

Self-host

Production with domains

The CLI writes the runtime env files into ~/.headlessx/repo, keeps the saved mode, and uses Docker plus Compose for the app stack.

Rare public defaults

Current host-side defaults are:

  • web: 34872
  • api: 38473
  • postgres: 35432
  • redis: 36379
  • html-to-md: 38081
  • yt-engine: 38090

Container-internal ports stay stable:

  • web: 3000
  • api: 8000
  • postgres: 5432
  • redis: 6379
  • html-to-md: 8080
  • yt-engine: 8090

Manual fallback

If you intentionally want the compose layer without the CLI wrapper, use the repository files under infra/docker.

Populate at least:

  • DASHBOARD_INTERNAL_API_KEY
  • CREDENTIAL_ENCRYPTION_KEY
  • database values
  • REDIS_URL if your deployment differs from defaults

Mixed local setup

Run PostgreSQL and Redis in Docker, then run the apps locally.

PostgreSQL

Redis

Start the workspace

pnpm dev