install-with-web-app-steps.adoc

In order to install self-hosted runners, you will need to create a namespace and resource class token. To create resource classes and tokens, you need to be an organization admin in the VCS provider. You can read about namespaces and resource classes on the Concepts page.

You can view your installed runners on the inventory page, by clicking Runners on the left navigation.

1. On the CircleCI web app, navigate to Runners and select btn:[Create Resource Class].

2. Next, you will create a custom resource class to use when configuring jobs to use your self-hosted runners. If this is your organization’s first time using self-hosted runners. You will need to create or enter a namespace. If your organization already creates orbs, do not create a new namespace, but instead enter the namespace your organization uses for orbs here too. Enter aname for your self-hosted runner resource class.

   Tip	Each organization can only create a single namespace. While not required, we suggest using a lowercase representation of your CircleCI account name. CircleCI will populate your org name as the suggested namespace by default in the UI.

3. Copy and save the resource class token. Self-hosted runners use this token to claim work for the associated resource class.

   Caution

   The token cannot be retrieved again, be sure to store it safely.