Skip to main content
Version: v4 (current)

Getting Started

Orchestrator lets you run Unity builds on whatever machines you have -cloud, on-premise, or your local machine. It works as a built-in plugin for game-ci/unity-builder in GitHub Actions, or as a standalone CLI tool.

Prerequisites​

  • A Unity project
  • A cloud provider account (AWS or a Kubernetes cluster) or Docker installed locally
  • Provider credentials (as GitHub secrets or environment variables)

GitHub Actions​

When you set providerStrategy in game-ci/unity-builder, the orchestrator activates automatically. No separate install step is needed.

Basic example​

- uses: game-ci/unity-builder@v4
  with:
    providerStrategy: aws
    targetPlatform: StandaloneLinux64
    gitPrivateToken: ${{ secrets.GITHUB_TOKEN }}

Full workflow example​

name: Build
on: push

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: game-ci/unity-builder@v4
        env:
          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
          UNITY_SERIAL: ${{ secrets.UNITY_SERIAL }}
        with:
          providerStrategy: aws
          targetPlatform: StandaloneLinux64
          gitPrivateToken: ${{ secrets.GITHUB_TOKEN }}

Command Line​

1. Install​

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/game-ci/orchestrator/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/game-ci/orchestrator/main/install.ps1 | iex

2. Set credentials​

export UNITY_SERIAL="XX-XXXX-XXXX-XXXX-XXXX-XXXX"
export AWS_ACCESS_KEY_ID="..."
export AWS_SECRET_ACCESS_KEY="..."

3. Run a build​

game-ci build \
  --target-platform StandaloneLinux64 \
  --provider-strategy aws

See the CLI documentation for full details.

Choose a Provider​

ProviderBest for
AWS FargateFully managed, no servers
KubernetesExisting K8s clusters
Local DockerTesting locally before cloud

See Providers for the full list.

Next Steps​