ContextQMD
Back to Gitlabhq

Control GitLab Duo Agent Platform availability

doc/user/duo_agent_platform/turn_on_off.md

18.11.29.2 KB
Original Source

{{< details >}}

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

GitLab Duo Agent Platform is on by default. Agent Platform includes a set of features.

You can turn Agent Platform on or off:

  • On GitLab.com: For top-level groups.
  • On GitLab Self-Managed: For instances.

Turn GitLab Duo Agent Platform on or off

On GitLab.com

{{< details >}}

  • Tier: Free, Premium, Ultimate

{{< /details >}}

{{< history >}}

  • Available on the Free tier on GitLab.com with GitLab Credits in GitLab 18.10.

{{< /history >}}

Prerequisites:

  • The Owner role for the top-level group.

To turn Agent Platform on or off for a top-level group:

  1. In the top bar, select Search or go to and find your top-level group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo Agent Platform, select or clear the Turn on GitLab Duo Agentic Chat, agents, and flows checkbox.
  5. Select Save changes.

Agent Platform availability changes for all subgroups and projects.

When Agent Platform is turned off, related settings for flows and foundational agents are hidden.

On GitLab Self-Managed

Prerequisites:

  • Administrator access.

To turn Agent Platform on or off for an instance:

  1. In the upper-right corner, select Admin.
  2. In the left sidebar, select GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo Agent Platform, select or clear the Turn on GitLab Duo Agentic Chat, agents, and flows checkbox.
  5. Select Save changes.

When Agent Platform is turned off, related settings for flows and foundational agents are hidden.

Turn GitLab Duo on or off

GitLab Duo is on by default. You can turn GitLab Duo on or off:

  • On GitLab.com: For top-level groups, other groups or subgroups, and projects.
  • On GitLab Self-Managed: For instances, groups or subgroups, and projects.

On GitLab.com

{{< details >}}

  • Tier: Free, Premium, Ultimate

{{< /details >}}

{{< history >}}

  • Available on the Free tier on GitLab.com with GitLab Credits in GitLab 18.10.

{{< /history >}}

For a top-level group

Prerequisites:

  • The Owner role for the top-level group.

To change GitLab Duo availability for a top-level group:

  1. In the top bar, select Search or go to and find your top-level group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo availability, select an option.
  5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a group or subgroup

Prerequisites:

  • The Owner role for the group or subgroup.

To change GitLab Duo availability for a group or subgroup:

  1. In the top bar, select Search or go to and find your group or subgroup.
  2. Select Settings > General.
  3. Expand GitLab Duo features.
  4. Under GitLab Duo availability, select an option.
  5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a project

Prerequisites:

  • The Owner or Maintainer role for the project.

To change GitLab Duo availability for a project:

  1. In the top bar, select Search or go to and find your project.
  2. Select Settings > General.
  3. Expand GitLab Duo.
  4. Turn the GitLab Duo toggle on or off.
  5. Select Save changes.

On GitLab Self-Managed

For an instance

Prerequisites:

  • Administrator access.

To change GitLab Duo availability for an instance:

  1. In the upper-right corner, select Admin.
  2. In the left sidebar, select GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo availability, select an option.
  5. Select Save changes.

For a group or subgroup

Prerequisites:

  • The Owner role for the group or subgroup.

To change GitLab Duo availability for a group or subgroup:

  1. In the top bar, select Search or go to and find your group or subgroup.
  2. Select Settings > General.
  3. Expand GitLab Duo features.
  4. Under GitLab Duo availability, select an option.
  5. Select Save changes.

GitLab Duo availability changes for all subgroups and projects.

For a project

Prerequisites:

  • The Owner or Maintainer role for the project.

To change GitLab Duo availability for a project:

  1. In the top bar, select Search or go to and find your project.
  2. Select Settings > General.
  3. Expand GitLab Duo.
  4. Turn the GitLab Duo toggle on or off.
  5. Select Save changes.

Turn GitLab Duo Core on or off

GitLab Duo Core is included with Premium and Ultimate subscriptions.

  • If you are an existing customer from GitLab 17.11 or earlier, you must turn on features for GitLab Duo Core.
  • If you are a new customer in GitLab 18.0 or later, GitLab Duo Core is automatically turned on and no further action is needed.

If you were an existing customer with a Premium or Ultimate subscription before May 15, 2025, when you upgrade to GitLab 18.0 or later, to use GitLab Duo Core, you must turn it on.

On GitLab.com

{{< details >}}

  • Tier: Free, Premium, Ultimate

{{< /details >}}

{{< history >}}

  • Available on the Free tier on GitLab.com with GitLab Credits in GitLab 18.10.

{{< /history >}}

Prerequisites:

  • The Owner role for the top-level group.

To change GitLab Duo Core availability for a top-level group:

  1. In the top bar, select Search or go to and find your top-level group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo availability, select an option.
  5. Under GitLab Duo Core, select or clear the Turn on GitLab Duo Agent Platform access checkbox. If you selected Always off for GitLab Duo availability, you cannot access this setting.
  6. Select Save changes.

It might take up to 10 minutes for the change to take effect.

On GitLab Self-Managed

Prerequisites:

  • Administrator access.

To change GitLab Duo Core availability for an instance:

  1. In the upper-right corner, select Admin.
  2. In the left sidebar, select GitLab Duo.
  3. Select Change configuration.
  4. Under GitLab Duo availability, select an option.
  5. Under GitLab Duo Core, select or clear the Turn on GitLab Duo Agent Platform access checkbox. If you selected Always off for GitLab Duo availability, you cannot access this setting.
  6. Select Save changes.

Turn on beta and experimental features

GitLab Duo features that are experimental and beta are turned off by default. These features are subject to the Testing Agreement.

On GitLab.com

{{< details >}}

  • Tier: Free, Premium, Ultimate

{{< /details >}}

{{< history >}}

  • Available on the Free tier on GitLab.com with GitLab Credits in GitLab 18.10.

{{< /history >}}

Prerequisites:

  • The Owner role for the top-level group.

To turn on GitLab Duo experiment and beta features for a top-level group:

  1. In the top bar, select Search or go to and find your group.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Under Feature preview, select Turn on experiment and beta GitLab Duo features.
  5. Select Save changes.

This setting cascades to all projects that belong to the group.

On GitLab Self-Managed

{{< tabs >}}

{{< tab title="In 17.4 and later" >}}

In GitLab 17.4 and later, follow these instructions to turn on GitLab Duo experiment and beta features for your GitLab Self-Managed instance.

Prerequisites:

  • Administrator access.

To turn on GitLab Duo experiment and beta features for an instance:

  1. In the upper-right corner, select Admin.
  2. Select Settings > GitLab Duo.
  3. Expand Change configuration.
  4. Under Feature preview, select Use experiment and beta GitLab Duo features.
  5. Select Save changes.

{{< /tab >}}

{{< tab title="In 17.3 and earlier" >}}

Prerequisites:

To turn on GitLab Duo experiment and beta features for an instance:

  1. In the upper-right corner, select Admin.

  2. Select Settings > GitLab Duo.

  3. Expand Change configuration.

  4. Under Feature preview, select Use experiment and beta GitLab Duo features.

  5. Select Save changes.

  6. For GitLab Duo Chat to work immediately, manually synchronize your subscription.

    If you do not manually synchronize your subscription, it might take up to 24 hours to activate GitLab Duo Chat on your instance.

{{< /tab >}}

{{< /tabs >}}