Skip to main content

Running Bitrise builds on-premise

You can run Bitrise builds on your own hardware or virtual environment by installing the Bitrise agent and connect it to your Bitrise Workspace.

To do so, you need to get the Bitrise agent 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 agent 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 agent pools in your Workspace settings page on bitrise.io: Configuring agent 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. 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.

  5. Connect the agent on your machine to your Bitrise workspace.

    macOS

    Linux

    • sudo sed -i '' 's/BITRISE_AGENT_TOKEN/<YOUR_AGENT_POOL_TOKEN>/' ~/Library/LaunchDaemons/io.bitrise.self-hosted-agent.plist
sudo launchctl load -w ~/Library/LaunchDaemons/io.bitrise.self-hosted-agent.plist
    • sudo sed -i 's/BITRISE_AGENT_TOKEN/<YOUR_AGENT_POOL_TOKEN>/' /etc/systemd/system/bitrise-den-agent.service
sudo systemctl start bitrise-den-agent.service
In this section:

A Workspace is an environment that allows you to manage your Bitrise apps and the team members working on the apps. You can create multiple Workspaces, and you can be invited to Workspaces by other Bitrise users. To be able to add apps and run builds, you either need to be part of a Workspace, or you have to be an outside contributor on an app's team.