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:
Self-hosted runner terms agreement
1. Create namespace and resource class
2. Install CircleCI runner
Machine runner configuration example
Once you have installed configuration runner, select Continue in the CircleCI web app and you will be presented with an example configuration snippet showing a job configured to use your new self-hosted runner resource class.
The fields you must set for a specific job to run using your machine runners are:
-
machine: true -
resource_class: <namespace>/<resource-class>
Simple example of how you could set up a job:
version: 2.1
workflows:
build-workflow:
jobs:
- runner
jobs:
runner:
machine: true
resource_class: <namespace>/<resource-class>
steps:
- run: echo "Hi I'm on Runners!"The job will then execute using your self-hosted runner when you push the .circleci/config.yml to your VCS provider.
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.