Skip to main content

On Premise

Cirun also supports spinning up runners on your own infrastructure. At the moment only Apple Silicon Macs are supported. If you have a Mac Mini or a Mac Pro with Apple Silicon then you can use Cirun to spin up runners on your own machine. Support for linux and windows for on-prem is coming soon. The setup is fairly simple and can be done in a few minutes. You need to install cirun-agent on your machine, which will then connect to cirun's API to spin up on-demand ephemeral VMs on your machine for GitHub actions.

Setting up cirun-agent on Apple Silicon Mac​

  1. Create an API token on the Cirun Dashboard

  2. Install the cirun-agent by running the following command:

    curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/cirunlabs/cirun-agent/refs/heads/main/install.sh | sh

  3. Start the agent by running the following command:

    cirun-agent --api-token <API_TOKEN> &

  4. Create a .cirun.yml file in your repository with the following content:

    runners:
      - name: cirun-macos-runner
        cloud: on_prem
        instance_type: 8vcpu-8gb-51gb
        machine_image: "cirunlabs/macos-sequoia-runner:latest"
        region: RegionOne
        labels:
          - cirun-macos-runner

Now you can push to your repository and your actions will run on your Apple Silicon Mac, assuming you have a workflow file with runs-on: cirun-macos-runner-${{ github.run_id }} and you have cirun configured in your repository by installing the GitHub App and marking the repository as active on the Cirun Dashboard https://cirun.io/admin/repositories.