Self-hosting
Own your build environment. Learn how GenuineCI uses Apple Silicon Macs to run workflows.
Run in your own environment
Section titled “Run in your own environment”GenuineCI is open-source CI. You can set up your own environment with Apple Silicon Macs as build machines.
The source code and configuration files are available in the GitHub repository.
Main components
Section titled “Main components”| Component | Role |
|---|---|
| Dashboard | Manage teams, repositories, and build results |
| API / planner | Plan workflows from GitHub events |
| Worker | Execute build jobs on Macs |
| GitHub App | Connect repositories and receive events |
You do not need to start these components just to run Dart workflows locally. Try the Quickstart.
Local development environment
Section titled “Local development environment”The repository includes a command that starts the API, Firebase Auth Emulator, Orchard Controller, and Mac workers for development.
genuineci dev startRun this command inside a checkout of the GenuineCI source code. Prepare Docker Compose 2.24.4 or later, the Compose configuration and credentials, and a base-macos VM beforehand.
dev startis for local development. It does not automatically complete production deployment or authentication setup.
Detailed setup
Section titled “Detailed setup”See the current CLI README for prerequisites and development startup instructions.
For production, configure the GitHub App, authentication, networking, secrets, and build machine management for your environment. Questions and suggestions are welcome on GitHub Issues.