Self-hosting
Own your build environment. Learn how OpenCI uses Firebase, GCP and Apple Silicon Macs.
Run in your own environment
Section titled “Run in your own environment”OpenCI is open-source CI. Its control plane uses Firebase and GCP; Apple Silicon Macs provide build capacity through Orchard.
The source code and configuration files are available in the GitHub repository.
Main components
Section titled “Main components”| Component | Role |
|---|---|
| Dashboard and Firebase Auth | Sign in and manage teams and builds |
| Firebase SQL Connect | Store teams, jobs, logs and billing state |
| Firebase Functions | Receive webhooks, plan jobs and dispatch builds |
| Cloud Run executor | Run workflows through Orchard and record results |
| Orchard Controller and Mac workers | Allocate and run macOS VMs |
| GitHub App | Connect repositories and receive events |
You do not need to deploy these components to run Dart workflows locally. Start with the Quickstart.
Development and deployment
Section titled “Development and deployment”The former API servers, PostgreSQL Compose stack and the old CLI's dev start command have been retired. The repository still provides a standalone Firebase Auth Emulator. Functions, Data Connect and build execution require their own setup.
- Firebase development and emulator setup
- Functions and Cloud Run deployment
- Orchard Controller deployment
For your deployment, configure project-specific identities, GitHub and Stripe settings, network access, secrets and Mac workers. The deployment record describes OpenCI's production project; use your own resource identifiers.