Subscription add-ons
DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
You can purchase subscription add-ons to give users in your organization access to more GitLab features. Subscription add-ons are purchased as additional seats in your subscription. Access to features provided by subscription add-ons is managed through seat assignment. Subscription add-ons can be assigned to billable users only.
Purchase GitLab Duo Pro seats
You can purchase additional GitLab Duo Pro seats for your group namespace or self-managed instance. After you complete the purchase, you must assign the seats to billable users so that they can use GitLab Duo Pro.
To purchase GitLab Duo Pro seats, you can use the Customers Portal, or you can contact the GitLab Sales team.
- Sign in to the GitLab Customers Portal.
- On the subscription card, select the vertical ellipsis ({ellipsis_v}).
- Select Buy GitLab Duo Pro.
- Enter the number of seats for GitLab Duo Pro.
- Review the Purchase summary section.
- From the Payment method dropdown list, select your payment method.
- Select Purchase seats.
Assign GitLab Duo Pro seats
Prerequisites:
- You must purchase the GitLab Duo Pro add-on.
- For self-managed and GitLab Dedicated, the GitLab Duo Pro add-on is available for GitLab 16.8 and later only.
After you purchase GitLab Duo Pro, you can assign seats to billable users to grant access to the add-on.
For GitLab.com
- On the left sidebar, select Search or go to and find your group.
- Select Settings > Usage Quotas.
- Select the GitLab Duo Pro tab.
- To the right of the user, turn on the toggle to assign GitLab Duo Pro.
To use Code Suggestions in any project or group, a user must be assigned a seat in at least one top-level group.
For self-managed
Prerequisites:
- You must be an administrator.
- On the left sidebar, at the bottom, select Admin Area.
- Select GitLab Duo Pro.
- If the GitLab Duo Pro menu item is not available, synchronize your subscription
after purchase:
- On the left sidebar, select Subscription.
- In Subscription details, to the right of Last sync, select synchronize subscription ({retry}).
- If the GitLab Duo Pro menu item is not available, synchronize your subscription
after purchase:
- To the right of the user, turn on the toggle to assign GitLab Duo Pro.
Configure network and proxy settings
For all self-managed AI features:
- Your firewalls and HTTP/S proxy servers must allow outbound connections
to
gitlab.com
andcloud.gitlab.com
on port443
. - Both
HTTP2
and the'upgrade'
header must be allowed, because GitLab Duo uses both REST and WebSockets. - To use an HTTP/S proxy, both
gitLab_workhorse
andgitLab_rails
must have the necessary web proxy environment variables set. - Check for restrictions on WebSocket (
wss://
) traffic towss://gitlab.com/-/cable
and other.com
domains. Network policy restrictions onwss://
traffic can cause issues with some GitLab Duo Chat services. Consider policy updates to allow these services.
Assign seats in bulk
To assign seats in bulk, you can use this GraphQL API endpoint.
This endpoint works for both self-managed and SaaS.
Administrators of self-managed instances can also assign users by using a Rake task.
Purchase additional GitLab Duo Pro seats
You can purchase additional GitLab Duo Pro seats for your group namespace or self-managed instance. After you complete the purchase, the seats are added to the total number of GitLab Duo Pro seats in your subscription.
Prerequisites:
- You must purchase the GitLab Duo Pro add-on.
For GitLab.com
- On the left sidebar, select Search or go to and find your group.
- Select Settings > Usage Quotas.
- Select the GitLab Duo Pro tab.
- Select Add seats.
- In the Customers Portal, in the Add additional seats field, enter the number of seats. The amount cannot be higher than the number of seats in the subscription associated with your group namespace.
- In the Billing information section, select the payment method from the dropdown list.
- Select the Privacy Policy and Terms of Service checkbox.
- Select Purchase seats.
- Select the GitLab SaaS tab and refresh the page.
For self-managed and GitLab Dedicated
Prerequisites:
- You must be an administrator.
- Sign in to the GitLab Customers Portal.
- On the GitLab Duo Pro section of your subscription card click Add seats button.
- Enter the number of seats. The amount cannot be higher than the number of seats in the subscription.
- Review the Purchase summary section.
- From the Payment method dropdown list, select your payment method.
- Select Purchase seats.
Start GitLab Duo Pro trial
DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
On GitLab.com
Prerequisites:
- You must have an active paid Premium or Ultimate subscription.
- On the left sidebar, select Search or go to and find your group.
- Select Settings > Billing.
- Select Start a free GitLab Duo Pro trial.
- Complete the fields.
- Select Continue.
- If prompted, select the group that the trial should be applied to.
- Select Activate my trial.
- Assign seats to the users who need access.
On Self-managed and GitLab Dedicated
Prerequisites:
- You must have an active paid Premium or Ultimate subscription.
- You must have GitLab 16.8 or later and your instance must be able to synchronize your subscription data with GitLab.
- The user who registers for the trial must be listed as the subscription contact for the customer account and use same email address associated with that role.
-
Find your subscription ID:
- In the Customers Portal, on the Subscriptions & purchases page.
- In the email sent after you purchased your subscription.
The ID usually looks like
A-S00123456
. -
Go to the GitLab Duo Pro trial page.
-
Complete the fields.
-
Select Submit.
The trial automatically syncs to your instance within 24 hours. After the trial has synced, assign seats to users that you want to access GitLab Duo Pro.