/ opencodehub / docs-site / src / content / docs / tutorials / self-hosted-docker-nginx.md
swadhinbiswas ✨ feat(cli): harden auth, TLS, retries, and repo parsing · 1/22/2026
3ac03a2
37 lines · 810 Bytes
Raw Download

title: "Self‑Hosted with Docker + Nginx"
description: "Deploy OpenCodeHub behind a reverse proxy with HTTPS."

This tutorial combines the Docker deployment guide with an Nginx reverse proxy setup.

1) Start services with Docker

cp .env.example .env
# Edit .env with production values

docker-compose up -d

2) Configure Nginx

Follow the administration/deploy-nginx guide to configure TLS termination and proxy rules.

3) Seed admin user

docker-compose exec app bun run scripts/seed-admin.ts

4) Validate

  • Open your instance URL
  • Create a repository
  • Test git clone over HTTP or SSH

Tips

  • Enable ENABLE_ACTIONS=true if you plan to run workflows.
  • Set RUNNER_ENABLED=true and bind the Docker socket for runners.