install-machine-runner-3-on-linux.adoc

contentTags
platform Cloud Server v4.4+

Install machine runner 3 on Linux

This page describes how to install CircleCI’s machine runner 3 on Linux.

Prerequisites

To install machine runners and run jobs, you will need to have root access, and have the following utilities and tools installed on your system:

• Coreutils

• curl

• sha256sum (if not pre-installed):

  • sudo apt install coreutils for Ubuntu/Debain

  • sudo yum install coreutils for Red Hat

• tar

• Gzip

• sepolicy (RHEL 8 only)

• rpmbuild (RHEL 8 only)

• GPG 2.1+

• The CircleCI CLI if you wish to install runners from the command line

Self-hosted runner terms agreement

../_includes/snippets/runner/terms.adoc

1. Create namespace and resource class

../_includes/snippets/runner/install-with-web-app-steps.adoc

../_includes/snippets/runner/install-with-cli-steps.adoc

2. Install CircleCI runner

../_includes/snippets/runner/machine-runner-deb-package-install.adoc

../_includes/snippets/runner/machine-runner-rpm-package-install.adoc

../_includes/snippets/machine-runner-example.adoc

Troubleshooting

Refer to the Troubleshoot Machine Runner section of the Troubleshoot Self-hosted Runner guide if you encounter issues installing or running machine runner on Linux.

Additional resources

• Machine runner 3 macOS Homebrew installation

• Machine runner 3 Windows installation

• Machine runner 3 Docker installation

• Manual installation for machine runner 3

• Machine runner 3 configuration reference