• AlmaLinux
• Amazon Linux
• CentOS and Scientific Linux
• Debian
• openSUSE Leap and SUSE Linux Enterprise Server
• Oracle Linux
• Raspberry Pi OS
• Red Hat Enterprise Linux
• Ubuntu
• Update GitLab package sources after upgrading the OS
• Update both GitLab and the operating system
• Corrupted Postgres indexes after upgrading the OS
• Packages for ARM64
• OS versions that are no longer supported

Supported operating systems

GitLab officially supports long term support (LTS) versions of operating systems. Some operating systems, such as Ubuntu, have a clear distinction between LTS and non-LTS versions. However, there are other operating systems, openSUSE for example, that don’t follow the LTS concept.

To avoid confusion, all the operating systems supported by GitLab are listed on the installation page.

AlmaLinux

These versions of AlmaLinux are supported.

Amazon Linux

These versions of Amazon Linux are supported.

CentOS and Scientific Linux

These versions of CentOS and Scientific Linux are supported.

Debian

These versions of Debian are supported.

openSUSE Leap and SUSE Linux Enterprise Server

These versions of openSUSE Leap and SUSE Linux Enterprise Server are supported.

Oracle Linux

These versions of Oracle Linux are supported.

Raspberry Pi OS

These versions of Raspberry Pi OS are supported.

Red Hat Enterprise Linux

These versions of Red Hat Enterprise Linux are supported.

Ubuntu

These versions of Ubuntu are supported.

Update GitLab package sources after upgrading the OS

After upgrading the operating system, you might also need to update the GitLab package source URL in your package manager configuration.

If your package manager reports that no further updates are available, but you know updates exist, repeat the instructions on the Linux package install guide to add the GitLab package repository. Future GitLab upgrades are fetched according to your upgraded operating system.

Update both GitLab and the operating system

To upgrade both the operating system (OS) and GitLab:

1. Upgrade the OS.
2. Check if it’s necessary to update the GitLab package sources.
3. Upgrade GitLab.

Corrupted Postgres indexes after upgrading the OS

As part of upgrading the operating system, if your glibc version changes, then you must follow Upgrading operating systems for PostgreSQL to avoid corrupted indexes.

Packages for ARM64

GitLab provides arm64/aarch64 packages for some supported operating systems. You can see if your operating system architecture is supported in the table above.

OS versions that are no longer supported

GitLab provides Linux packages for operating systems only until their end-of-life (EOL) date. After the EOL date, GitLab stops releasing official packages. The list of deprecated operating systems and the final GitLab release for them can be found below: