Skip to main content

Running Bitrise builds on-premise

You can run Bitrise builds on self-hosted infrastructure - that is, that hardware or virtualized environments that you control - while taking advantage of every feature the Bitrise website offers. To do so, you just need to install the Bitrise agent on your own infrastructure and connect it to your Workspace. Once that is done, you can run builds from your Bitrise account, using the Bitrise UI as usual.

bitrise-runner-diagram.png

When to use the on-premise runnerClick to copy link​

If you need to run Bitrise builds on infrastructure that you control, Bitrise offers two options: using Amazon EC2 Mac or Linux instances, or the on-premise runner option.

We only recommend using the on-premise runner if you have the necessary machines or use a cloud provider other than AWS for your infrastructure needs. The on-premise runner is NOT plug and play: you need to make sure all necessary tools and services are installed on your machines.

If you do have an AWS account for managing your infrastructure, we recommend checking our AWS offering.

Setting up Bitrise on-premiseClick to copy link​

To be able to run Bitrise builds on your own infrastructure, you need to get the Bitrise runner from Homebrew and then configure your network to be able to access two Bitrise service endpoints.

Tools and services

Please note that when using the Bitrise runner this way, you have to make sure you have all the tools you need installed on the machine. For now, we don't provide preinstalled tools for this on-premise solution.

  1. Configure Bitrise runner pools in your Workspace settings page on bitrise.io: Configuring runner pools.

    Make sure to get the token from the process.

  2. Fetch the bitrise-den-agent formula from Homebrew.

    brew tap bitrise-io/den-agent

  3. Install the latest version.

    brew install bitrise-den-agent
    Installing a specific version

    You can also install a specific version by amending the version number to the command:

    brew install [email protected]

  4. Install the Bitrise CLI. The CLI runs the builds based on YAML configurations.

    brew install bitrise

  5. Configure your network to be able to access the following two services:

    • https://den.services.bitrise.io
    • https://build-log.services.bitrise.io

    The agent needs to be able to access both of these to run your builds and communicate with the Bitrise website.

  6. Generate a service daemon template.

    You need the runner pool token to finish the process.

    sudo $(brew --prefix)/bin/create_bitrise_daemon.sh --bitrise-agent-intro-secret=YOUR_TOKEN --enable-agent-self-update

  7. Configure agent mode to clean up your build environment after a build: Cleaning up persistent build environments.