swadhinbiswas ✨ feat(cli): harden auth, TLS, retries, and repo parsing · 1/22/2026
bdf41c6
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
---
title: OpenCodeHub Documentation
description: The open-source, AI-native Git server with Stacked PRs and Smart Merge Queues.
hero:
title: OpenCodeHub
tagline: The fully self-hosted GitHub alternative with SSH hosting, CI/CD pipelines, and a modern developer experience.
---
import { Card, CardGrid } from "@astrojs/starlight/components";
## Why OpenCodeHub?
<CardGrid stagger>
<Card title="🚀 Stacked PRs" icon="rocket">
Break large features into small, dependent steps. Ship faster without the
review bottleneck.
</Card>
<Card title="🤖 AI Code Review" icon="star">
Built-in LLM agents (GPT-4/Claude) review your code for bugs and security
issues automatically.
</Card>
<Card title="🔀 Smart Merge Queue" icon="random">
Automate your merging strategy. Ensure `main` never breaks with speculative
CI runs.
</Card>
<Card title="🏠 Fully Self-Hosted" icon="laptop">
Keep your code on your servers. No "per-seat" pricing. No vendor lock-in.
</Card>
</CardGrid>
## Architecture Overview
OpenCodeHub is built on a modern, scalable architecture designed for performance and flexibility.
## Deploy Anywhere
<CardGrid>
<Card title="🐳 Docker" icon="add-document">
The recommended way to deploy. Full Docker Compose setup with PostgreSQL and
Redis. [Deploy with Docker →](/administration/deploy-docker/)
</Card>
<Card title="🦭 Podman" icon="add-document">
Rootless containers with native systemd integration. Ideal for
security-focused deployments. [Deploy with Podman
→](/administration/deploy-podman/)
</Card>
<Card title="☁️ Cloudflare" icon="add-document">
Use Cloudflare Tunnel + R2 for zero-port exposure and S3-compatible storage.
[Deploy with Cloudflare →](/administration/deploy-cloudflare/)
</Card>
<Card title="🌐 Nginx" icon="add-document">
Production-ready reverse proxy config with SSL and Git-specific
optimizations. [Configure Nginx →](/administration/deploy-nginx/)
</Card>
</CardGrid>
## Tech Stack
| Layer | Technology |
| ------------ | ------------------------------------- |
| **Frontend** | Astro, React, Tailwind CSS, shadcn/ui |
| **Backend** | Node.js, Hono (API), simple-git |
| **Database** | PostgreSQL, Turso (LibSQL), SQLite |
| **Storage** | Local disk, S3, R2, Google Drive |
| **Auth** | JWT, 2FA, OAuth (GitHub, Google) |
| **CI/CD** | GitHub Actions compatible runners |
## Quick Links
<CardGrid>
<Card title="Installation" icon="add-document">
Get OpenCodeHub running in minutes with Docker or Node.js. [Read the guide
→](/getting-started/installation/)
</Card>
<Card title="CLI Reference" icon="seti:shell">
Learn the `och` CLI commands for managing stacks and repositories. [View
commands →](/reference/cli-commands/)
</Card>
<Card title="API Reference" icon="open-book">
Integrate with OpenCodeHub using the REST API. [Explore the API
→](/api/rest-api/)
</Card>
<Card title="Contributing" icon="github">
Help make OpenCodeHub better. Set up your local dev environment. [Start
contributing →](/development/contributing/)
</Card>
</CardGrid>
## Storage Options
:::tip[Performance Recommendation]
For best performance, use **local SSD storage** in production. Object storage (S3/R2) introduces latency. See [Storage Adapters](/guides/storage-adapters/#️-performance-considerations) for details.
:::
| Storage Type | Performance | Cost | Best For |
| ---------------- | ----------- | ---- | ----------------------- |
| **Local SSD** | ⚡ Fastest | $$ | Production, self-hosted |
| **S3/R2** | 🐢 Slow | $ | Backup, serverless |
| **Google Drive** | 🐢 Slow | Free | Personal projects |