Skip to main content

Bitrise ビルドをオンプレミスで実行する


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

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.


When to use the on-premise runner

If you need to run Bitrise builds on infrastructure that you control, Bitrise offers two options: using AWS EC2 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-premise

これを行うには、Bitrise エージェントを次のサイトから入手する必要があります。 自作 次に、2 つの Bitrise サービス エンドポイントにアクセスできるようにネットワークを構成します。


この方法で Bitrise エージェントを使用する場合は、必要なツールがすべてマシンにインストールされていることを確認する必要があることに注意してください。現時点では、このオンプレミス ソリューション用のプレインストール ツールは提供されていません。



  1. Bitrise エージェント プールを構成します。 ワークスペースの設定 のページ: セルフホスト型ビルド用のエージェント プールの構成


  2. をフェッチします bitrise-den-agent Homebrew の公式。

    brew tap bitrise-io/den-agent
  3. 最新バージョンをインストールします。

    brew install bitrise-den-agent



    brew install [email protected]
  4. 次の 2 つのサービスにアクセスできるようにネットワークを構成します。



    エージェントは、ビルドを実行し、Bitrise Web サイトと通信するために、これらの両方にアクセスできる必要があります。

  5. Generate a service daemon template.

    You need the runner pool token to finish the process.

    brew create-daemon --bitrise-agent-intro-secret=YOUR_AGENT_POOL_TOKEN
  6. マシン上のエージェントを Bitrise ワークスペースに接続します。

    sudo mkdir -p ~/Library/LaunchDaemons 
    sudo chown root:wheel ~/Library/LaunchDaemons 
    sudo cp /opt/homebrew/io.bitrise.self-hosted-agent.plist ~/Library/LaunchDaemons 
    sudo chown root:wheel ~/Library/LaunchDaemons/io.bitrise.self-hosted-agent.plist 
    sudo launchctl load -w ~/Library/LaunchDaemons/io.bitrise.self-hosted-agent.plist

We provide the Linux Bitrise Runner binary with x86_64 architecture only since Google isn’t supporting arm64 with Android tools yet. You can vote in this Google issue to change this.

On your Apple Silicon machine, you can run the Linux Bitrise Runner with docker using the correct flags: --platform linux/x86_64.

If you require an arm64 Linux Bitrise Runner binary, please visit the Bitrise Roadmap and cast your vote.

  1. Bitrise エージェント プールを構成します。 ワークスペースの設定 のページ: セルフホスト型ビルド用のエージェント プールの構成


  2. GPG 公開キーを追加します。

    curl -fsSL | 
    sudo gpg --dearmor -o /usr/share/keyrings/DEB-GPG-KEY-bitrise.gpg
  3. Bitrise DEN エージェント deb パッケージ リポジトリを追加します。

    echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/DEB-GPG-KEY-bitrise.gpg] stable main' | 
    sudo tee /etc/apt/sources.list.d/den-agent-deb.list
  4. エージェントをインストールし、マシン上の Bitrise ワークスペースに接続します。

    プロセスを完了するには、エージェント プール トークンが必要です。

    sudo apt update
    sudo apt install bitrise-den-agent
    sudo /usr/bin/ YOUR_AGENT_POOL_TOKEN