continuous_integration.md

stage: Verify
group: Pipeline Execution
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments
title: CI/CD Admin area settings

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab Self-Managed

{{< /details >}}

The Admin area has the instance settings for CI/CD-related features, including runners, job artifacts, and the package registry.

Auto DevOps

To enable (or disable) Auto DevOps for all projects:

1. On the left sidebar, at the bottom, select Admin.
2. Select Settings > CI/CD.
3. Check (or uncheck to disable) the box that says Default to Auto DevOps pipeline for all projects.
4. Optionally, set up the Auto DevOps base domain which is used for Auto Deploy and Auto Review Apps.
5. Select Save changes for the changes to take effect.

Every existing project and newly created ones that don't have a .gitlab-ci.yml use the Auto DevOps pipelines.

Runners

Enable instance runners for new projects

You can set all new projects to have instance runners available by default.

1. On the left sidebar, at the bottom, select Admin.
2. Select Settings > CI/CD.
3. Expand Continuous Integration and Deployment.
4. Select the Enable instance runners for new projects checkbox.

Any time a new project is created, the instance runners are available.

Add a message for instance runners

To display details about the instance runners in all projects' runner settings:

1. On the left sidebar, at the bottom, select Admin.
2. Select Settings > CI/CD.
3. Expand Continuous Integration and Deployment.
4. Enter text, including Markdown if you want, in the Instance runner details field.

To view the rendered details:

1. On the left sidebar, select Search or go to and find your project or group.
2. Select Settings > CI/CD.
3. Expand Runners.

Enable a project runner for multiple projects

If you have already registered a project runner you can assign that runner to other projects.

To enable a project runner for more than one project:

1. On the left sidebar, at the bottom, select Admin.
2. From the left sidebar, select CI/CD > Runners.
3. Select the runner you want to edit.
4. In the upper-right corner, select Edit ({{< icon name="pencil" >}}).
5. Under Restrict projects for this runner, search for a project.
6. To the left of the project, select Enable.
7. Repeat this process for each additional project.

Disable runner version management

{{< history >}}

• Introduced in GitLab 15.10.

{{< /history >}}

By default, GitLab instances periodically fetch official runner version data from GitLab.com to determine whether the runners need upgrades.

To disable your instance fetching this data:

1. On the left sidebar, at the bottom, select Admin.
2. Select Settings > CI/CD.
3. Expand Runners.
4. In the Runner version management section, clear the Fetch GitLab Runner release version data from GitLab.com checkbox.
5. Select Save changes.

Restrict runner registration by all users in an instance

{{< history >}}

• Enabled on GitLab.com and GitLab Self-Managed in GitLab 15.5.

{{< /history >}}

GitLab administrators can adjust who is allowed to register runners, by showing and hiding areas of the UI. This setting does not affect the ability to create a runner from the UI or through an authenticated API call.

When the registration sections are hidden in the UI, members of the project or group must contact administrators to enable runner registration in the group or project. If you plan to prevent registration, ensure users have access to the runners they need to run jobs.

By default, all members of a project and group are able to register runners.

To restrict all users in an instance from registering runners:

1. On the left sidebar, at the bottom, select Admin.
2. Select Settings > CI/CD.
3. Expand Runners.
4. In the Runner registration section, clear the Members of the project can register runners and Members of the group can register runners checkboxes to remove runner registration from the UI.
5. Select Save changes.

{{< alert type="note" >}}

After you disable runner registration by members of a project, the registration token automatically rotates. The token is no longer valid and you must use the new registration token for the project.

{{< /alert >}}

Restrict runner registration by all members in a group

Prerequisites:

• Runner registration must be enabled for all users in the instance.

GitLab administrators can adjust group permissions to restrict runner registration by group members.

To restrict runner registration by members in a specific group:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Groups and find your group.
3. Select Edit.
4. Clear the New group runners can be registered checkbox if you want to disable runner registration by all members in the group. If the setting is read-only, you must enable runner registration for the instance.
5. Select Save changes.

Allow runner registration tokens