Register a shared runner

On self-managed GitLab, this feature is not available. To make it available, ask an administrator to enable the feature flag named create_runner_workflow_for_admin. On, this feature is available but can be configured by administrators only.


  • You must be an administrator to register a shared runner.

To register a shared runner:

  1. On the top bar, select Main menu > Admin.
  2. On the left sidebar, select CI/CD > Runners.
  3. Select New instance runner.
  4. Select a platform.
  5. Optional. Enter a description.
  6. Optional. Enter a maintenance note.
  7. Optional. Enter configurations for the runner.
  8. Select Submit.
  9. Follow the instructions to register the runner from the command line.
The token only displays in the UI for a short period of time during registration, and is then saved in config.toml.