Contact UsGet started

Creating and activating a Managed Service for GitLab instance

Written by
Improved by
Updated at April 22, 2025

Creating a GitLab instance

To create a Managed Service for GitLab instance, you need the vpc.user role and the gitlab.editor role or higher. For information on assigning roles, see the Identity and Access Management documentation.

Warning

Once you have created an instance, you cannot change its network configuration, i.e., availability zone and subnet.

  1. In the management console, select the folder where you want to create a GitLab instance.

  2. Select Managed Service for GitLab.

  3. Click Create instance.

  4. At the top of the page:

    1. Enter the instance name. It must be unique throughout Yandex Cloud.

      • It must be from 2 to 63 characters long.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

    2. (Optional) Enter a description of the instance.

    3. (Optional) Add tags to break instances into logical groups.

    4. (Optional) Set instance protection against accidental deletion by the user.

  5. Under Configuration:

    1. Select the instance type. After you create an instance, you can change its type to a higher performing one.

    2. Specify the availability zone. After you create an instance, you cannot change its availability zone.

    3. Specify the subnet where the instance will be hosted. Currently, Yandex Cloud technical restrictions do not allow selecting a subnet with the 192.168.0.0/24 address range.

      The default security group for the selected network will be used for the instance. If you cannot open the GitLab web interface after you create the instance, configure your security group so that the rules allow incoming and outgoing traffic from required ports and IP addresses.

    4. Select the disk size. After you create an instance, you can increase its disk size.

    5. Specify the instance domain name: relevant DNS records will be automatically created for it in the .gitlab.yandexcloud.net domain.

      The domain name must be unique throughout Yandex Cloud.

      • Its length must be between 5 and 50 characters.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • It must not start or end with a dash character.

    6. Set up the retention period for automatic backups (in days).

    7. (Optional) Enable code approval rules. To do this, select the appropriate configuration for approval rules.

      Note

      The configuration you select affects the cost of using the instance's computing resources.

  6. Under Administrator data, specify:

    • Email: Email address of the GitLab instance administrator. This mailbox will receive an email with a link for creating a password.
    • Login: Administrator login.

  7. (Optional) Under Advanced settings, enable deletion of untagged images. This setting affects the amount of free disk space on the instance.

  8. Click Create.

  9. Wait for the instance to get ready: its status on the Managed Service for GitLab dashboard will change to Running. This may take some time.

Note

When you create an instance in Managed Service for GitLab, it automatically generates an SSL certificate. No additional configuration for using HTTPS is required.

Activating the GitLab instance

After the instance status changes to Running, activate the instance:

  1. Follow the link you received in your administrator mailbox after creating the instance.

    If you cannot open the GitLab web interface, create a separate security group and configure it so that the rules allow incoming traffic from the required ports and IP addresses.

  2. Change the administrator password.

  3. Log in using the administrator username and password.

Further on, to open the GitLab web interface, get detailed information about your instance and follow the link in Domain.

Previous
Getting information about instances
Next
Setting up security groups and access restrictions to an instance