Skip to main content

Most popular self-hosted Git tool to manage the DevOps lifecycle.

Simplify your toolchain and speed up software development with GitLab. As a complete DevOps platform, GitLab provides a CI/CD toolchain through one interface. At its core, GitLab serves as a centralized Git repository with all the features to plan, test, and release even faster. Customize workflows to make it work for your project or organization. Capabilities on GitLab scale from small teams to enterprise companies, with more than 100,000 customers across the world. Use GitLab to run Docker using custom images and a built-in container registry.

Deploying the GitLab Marketplace App

  1. Log in to the Cloud Manager and select the Marketplace link from the left navigation menu. This displays the Linode Compute Create page with the Marketplace tab pre-selected.
  2. Under the Select App section, select the app you would like to deploy.
  3. Fill out all required Options for the selected app as well as any desired Advanced Options (which are optional). See the Configuration Options section for details.
  4. Complete the rest of the form as discussed within the Getting Started > Create a Linode.
  5. Click the Create Linode button. Once the Linode has provisioned and has fully powered on, wait for the software installation to complete. If the Linode is powered off or restarted before this time, the software installation will likely fail. To determine if the installation has completed, open the Linode’s Lish console and wait for the system login prompt to appear.
  6. Follow the instructions within the Getting Started After Deployment section.

Software installation should complete within 10-15 minutes after the Linode has finished provisioning.

Configuration Options

GitLab Options

Here are the additional options available for this Marketplace App:

Admin Email for the serverE-Mail address for Let’s Encrypt SSL certificate. This is also used as the SOA email address if you also enter a domain. Required.
Your Linode API TokenYour Linode API Token is needed to create DNS records. If this is provided along with the subdomain and domain fields, the installation attempts to create DNS records via the Linode API. If you don’t have a token, but you want the installation to create DNS records, you must create one before continuing.
SubdomainThe subdomain you wish the installer to create a DNS record for during setup. The suggestion given is www. The subdomain should only be provided if you also provide a domain and API Token.
DomainThe domain name you wish to use with your application. The installer creates a DNS record for this domain during setup if you provide this field along with your API Token.
The limited sudo user to be created for the LinodeThis is the limited user account to be created for the Linode. This account has sudo user privileges.
The password for the limited sudo userSet a password for the limited sudo user. The password must meet the complexity strength validation requirements for a strong password. This password can be used to perform any action on your server, similar to root, so make it long, complex, and unique.
The SSH Public Key that will be used to access the LinodeIf you wish to access SSH via Public Key (recommended) rather than by password, enter the public key here.
Disable root access over SSH?Select Yes to block the root account from logging into the server via SSH. Select No to allow the root account to login via SSH.

General Options

For advice on filling out the remaining options on the Create a Linode form, see Creating a Compute Instance. Some options may be limited or have recommended values based on this Marketplace App:

  • Supported distributions: Debian 11, Ubuntu 20.04 LTS
  • Recommended minimum plan: 8GB Dedicated CPU Compute Instance

Getting Started After Deployment

The GitLab Marketplace App will install the following required s

Access the GitLab Site

Once your new Compute Instance has been fully deployed, follow the instructions below to access your new Gitlab app.

  1. Find the Gitlab root password: Before logging in to your Gitlab site, you need to obtain the Gitlab root password that was generated during provisioning.
    1. Log in to your new Compute Instance through Lish or SSH using either the root user or limited user and the associated password you entered when creating the instance.
    2. Enter the following command in the lish console or terminal session:
  2. Log in to your Gitlab site: Open a web browser and enter either your Compute Instance’s default rDNS domain or your domain name (if you entered one during deployment). See the Managing IP Addresses guide for information on viewing and setting the rDNS value.

When presented with a login screen, enter the following credentials:

  • Username: root
  • Password: Use the password you obtained in the previous step.

3. Reset the root password: Once you’re logged in, it’s recommended that you reset the root password. To do so, navigate to the following URL, replacing [domain] with the rDNS domain of your Compute instance or your custom domain:


You can now begin creating GitLab repositories, users, and more. See GitLab’s official documentation for more information.

GitLabRemote Git repository software.
PostfixPostfix is a free and open-source mail transfer agent that routes and delivers electronic mail.
UFWFirewall utility. Ports 22/tcp, 80/tcp, 443/tcp, 25, 587, and 110 for IPv4 and IPv6 will allow outgoing and incoming traffic.
Fail2BanFail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

The GitLab Marketplace App was built by Linode. For support regarding app deployment, contact Linode Support via the information listed in the sidebar. For support regarding the tool or software itself, visit GitLab Support.