Skip to content
OpenCodeHub Docs
Stacked PRs AI Review Merge Queue

OpenCodeHub Documentation

The fully self-hosted GitHub alternative with SSH hosting, CI/CD pipelines, AI code review, and a modern developer experience.

Get Started View on GitHub

Why OpenCodeHub?

Section titled “Why OpenCodeHub?”

Stacked PRs

Break large features into small, dependent steps. Graphite-style stacked branches with automatic rebase and merge readiness checks.

AI Code Review

Built-in LLM agents (GPT-4, Claude, Gemini, Groq, Ollama, and 10+ providers) review your code for bugs and security issues automatically.

Smart Merge Queue

Stack-aware merge queue with speculative CI builds, priority lanes, and conflict detection. Ensure main never breaks.

CI/CD Pipelines

GitHub Actions-compatible workflow engine with Docker-based runners, artifact storage, and secrets management.

Fully Self-Hosted

Keep your code on your servers. No per-seat pricing. No vendor lock-in. Deploy with Docker, Podman, or bare metal.

Package Registry

Built-in npm and Docker container registry. Host private packages alongside your source code.

Core Capabilities

Section titled “Core Capabilities”

Git Hosting

Full Git support with HTTP smart protocol and SSH. Repository forking, mirroring, LFS, and CODEOWNERS enforcement.

Pull Requests

Full PR lifecycle with inline comments, file-level approvals, review templates, reviewer routing rules, and auto-merge.

Issues & Projects

Issue tracking with custom fields and statuses. Drag-and-drop project boards with columns and cards.

Security

Secret scanning, vulnerability scanning, security policies, path-level permissions, and audit logging.

Webhooks & Automations

Outbound webhooks with HMAC signing. Rule-based automations for PR workflows, reviews, and deployments.

Organizations & Teams

Multi-tenant organizations with role-based access control, team management, and fine-grained permissions.

Deploy Anywhere

Section titled “Deploy Anywhere”

Docker

The recommended way to deploy. Full Docker Compose setup with PostgreSQL and Redis. Deploy with Docker →

Podman

Rootless containers with native systemd integration. Ideal for security-focused deployments. Deploy with Podman →

Coolify

Self-hosted PaaS alternative to Heroku/Render. Auto-deploy with built-in SSL. Deploy on Coolify →

NAS

Run on Synology, TrueNAS, or QNAP. Perfect for private home/team Git servers. Deploy on NAS →

Nginx

Production-ready reverse proxy config with SSL and Git-specific optimizations. Configure Nginx →

Tech Stack

Section titled “Tech Stack”
LayerTechnology
FrameworkAstro 4.x (SSR, Node standalone adapter)
FrontendReact 18, Tailwind CSS, Radix UI, Framer Motion
BackendAstro API Routes (175+ endpoints), GraphQL
DatabasePostgreSQL (prod), SQLite (dev), Turso/LibSQL (edge)
ORMDrizzle ORM (38 schema tables)
AuthJWT, bcryptjs, TOTP 2FA, OAuth (Google, GitHub), SSO/SAML, OIDC
Gitsimple-git, isomorphic-git, nodegit, ssh2
StorageLocal filesystem or S3-compatible (AWS, MinIO, R2, Garage, Wasabi)
CI/CDGitHub Actions-compatible engine, Docker-based runners
AIOpenAI, Anthropic, Google, Groq, Ollama, OpenRouter, Together, Bytez
QueueBullMQ + Redis
ObservabilityOpenTelemetry, Prometheus metrics, Pino logging

Quick Start

Section titled “Quick Start”
Terminal window
# Clone and start with Docker Compose
git clone https://github.com/swadhinbiswas/OpencodeHub.git
cd OpencodeHub
cp .env.example .env  # Edit secrets!
docker-compose up -d


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


# Open in browser
open http://localhost:4321
Section titled “Quick Links”