Introduction
What Does Orchestrator Do?
Orchestrator runs Unity builds on cloud infrastructure. Start jobs from GitHub Actions, the command line, or any CI system. Orchestrator provisions a cloud environment, sends your project to be built, and streams results back.
Your Machine / CI Cloud Provider
┌──────────────┐ git push ┌─────────────────┐
│ GitHub │ ─────────────────►│ AWS Fargate │
│ Actions, │ │ Kubernetes │
│ GitLab CI, │ ◄─────────────────│ Local Docker │
│ CLI, etc. │ build artifacts │ │
└──────────────┘ └─────────────────┘
│ │
│ Orchestrator handles: │
│ * Provisioning │
│ * Git sync + LFS │
│ * Caching (S3 / rclone) │
│ * Automatic cleanup │
└───────────────────────────────────┘
Orchestrator supports large projects with first-class Unity support and native cloud services like AWS Fargate and Kubernetes.
✅ Why Orchestrator?
- Flexible and elastic — balance speed and cost, configure CPU, memory, and disk per build
- Scale from zero — no idle servers, pay only while builds run
- Easy setup — minimal configuration to get started
- Extensible — run custom hooks, or bring your own provider plugin
❌ When You Don't Need It
- Your project is under 5 GB — standard GitHub runners should work fine
- You have dedicated build servers already running
📦 Supported Providers
| Cloud Provider | Description |
|---|---|
| AWS Fargate | Fully managed containers on AWS. No servers to maintain. |
| Kubernetes | Run on any Kubernetes cluster. |
| Local Docker | Docker containers on the local machine. |
| Local | Direct execution on the host machine. |
See Providers for the full list including custom and community providers.
🖥️ Supported Platforms
| Platform | Description |
|---|---|
| GitHub Actions | First-class support with Checks. |
| GitLab CI | Via the Command Line mode. |
| Command Line | Run from any terminal or script. |
| Any CI system | Anything that can run shell commands. |
🔗 External Links
- Releases — packaged with game-ci/unity-builder
- Pull Requests — open orchestrator PRs
- Issues — bugs and feature requests
- Discord — community chat
- Feedback Form — share your experience