Install the Linux package on OpenSUSE and SLES

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

See supported platforms for the full list of supported distributions and architectures.

Prerequisites

OS requirements:
- OpenSUSE Leap 15.6
- SLES 12
- SLES 15 SP6
See the installation requirements to learn about the minimum hardware requirements.
Before you begin, make sure you have correctly set up your DNS, and change https://gitlab.example.com to the URL at which you want to access your GitLab instance. The installation automatically configures and starts GitLab at that URL.
For https:// URLs, GitLab automatically requests a certificate with Let’s Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate, or just use http:// (without the s) for an unencrypted URL.

Enable SSH and open firewall ports

To open the needed firewall ports (80, 443, 22) and be able to access GitLab:

Enable and start the OpenSSH server daemon:
```
sudo systemctl enable --now sshd
```

With firewalld installed, open the firewall ports:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-service=ssh
sudo systemctl reload firewalld

Add the GitLab package repository

To install GitLab, first add the GitLab package repository.

Install the needed packages:
```
sudo zypper install curl
```

Use the following script to add the GitLab repository (you can paste the script’s URL to your browser to see what it does before piping it to bash):

curl "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh" | sudo bash

curl "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh" | sudo bash

Install the package

Install GitLab using your system’s package manager. You can customize the initial setup by configuring environment variables before installation.

If you don’t customize the root credentials during installation:

GitLab generates a random password and email address for the root administrator account.
The password is stored in /etc/gitlab/initial_root_password for 24 hours.
After 24 hours, this file is automatically removed for security reasons.

While you can also set the initial password in /etc/gitlab/gitlab.rb by setting gitlab_rails['initial_root_password'] = "password", it is not recommended. If you do set the password with this method, be sure to remove the password from /etc/gitlab/gitlab.rb as it only gets read with the first reconfigure after the package is installed.

Available environment variables

You can customize your GitLab installation by setting the following optional environment variables. These variables only work during the first installation and have no effect on subsequent reconfigure runs. For existing installations, use the password from /etc/gitlab/initial_root_password or reset the root password.

Variable	Purpose	Required	Example
`EXTERNAL_URL`	Sets the external URL for your GitLab instance	Recommended	`EXTERNAL_URL="https://gitlab.example.com"`
`GITLAB_ROOT_EMAIL`	Custom email for the root administrator account	Optional	`GITLAB_ROOT_EMAIL="admin@example.com"`
`GITLAB_ROOT_PASSWORD`	Custom password (8 characters minimum) for the root administrator account	Optional	`GITLAB_ROOT_PASSWORD="strongpassword"`

If GitLab can’t detect a valid hostname during installation, reconfigure won’t run automatically. In this case, pass any needed environment variables to your first gitlab-ctl reconfigure command.

Installation commands

Choose your GitLab edition and customize with the environment variables above:

Basic installation:

sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ee

With custom root credentials:

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ee

Basic installation:

sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ce

With custom root credentials:

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ce

Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, documentation, and behind the scenes stories from our development teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

If you do not opt-in to the security newsletter, you will not receive security alerts.