Self-Hosting Overview
Corbulo can be deployed in your own infrastructure for teams that need full control over their data, compliance posture, or network environment.Why Self-Host?
Data Sovereignty
Your source code and analysis data never leave your infrastructure. All processing happens within your network.
Compliance
Meet regulatory requirements that mandate data residency, audit controls, or air-gapped environments.
Custom AI Models
Use your own AI model provider — any OpenAI-compatible API works. Run models locally or through your preferred vendor.
Network Isolation
Deploy behind your firewall with no inbound internet access required beyond GitHub webhooks and AI provider APIs.
Deployment Options
Architecture
Corbulo consists of three application components backed by four infrastructure services:Required Infrastructure
You need to provision the following services. They can run alongside Corbulo or be managed separately (e.g., cloud-managed Postgres, hosted Redis).All four services are required. Corbulo will not start if any service is unreachable.
AI Model Configuration
Corbulo requires access to AI models for code analysis, architecture review, convention detection, and PR analysis. Any OpenAI-compatible API works, including:- OpenAI
- Azure OpenAI
- Anthropic (via OpenAI-compatible endpoints)
- OpenRouter
- Self-hosted models (vLLM, Ollama, etc.)
System Requirements
Docker Compose (small teams)
Kubernetes (large teams)
Infrastructure services (PostgreSQL, Redis, FalkorDB, Temporal) should be sized according to your repository count and team size. For production deployments with 50+ developers, use managed database services or dedicated nodes.
Networking
Inbound
Outbound
If you use a self-hosted AI model provider, no outbound access to external AI APIs is needed.
Next Steps
Docker Compose
Step-by-step deployment guide for small teams.
Kubernetes
Production deployment on Kubernetes with scaling and high availability.
Configuration Reference
Complete list of environment variables and their descriptions.