Supported operating systems

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

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.

amd64 and x86_64 refer to the same 64-bit architecture. The names arm64 and aarch64 are also interchangeable and refer to the same architecture.

AlmaLinux

These versions of AlmaLinux are supported.

Operating systemFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
AlmaLinux 8GitLab CE / GitLab EE 14.5.0x86_64, aarch64AlmaLinux installation documentation2029AlmaLinux details
AlmaLinux 9GitLab CE / GitLab EE 16.0.0x86_64, aarch64AlmaLinux installation documentation2032AlmaLinux details

Amazon Linux

These versions of Amazon Linux are supported.

Operating systemFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
Amazon Linux 2GitLab CE / GitLab EE 14.9.0amd64, arm64Amazon Linux 2 installation documentationJune 2026Amazon Linux details
Amazon Linux 2023GitLab CE / GitLab EE 16.3.0amd64, arm64Amazon Linux 2023 installation documentation2028Amazon Linux details

Debian

These versions of Debian are supported.

Operating systemFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
Debian 11GitLab CE / GitLab EE 14.6.0amd64, arm64Debian installation documentation2026Debian Linux details
Debian 12GitLab CE / GitLab EE 16.1.0amd64, arm64Debian installation documentationTBDDebian Linux details

openSUSE Leap and SUSE Linux Enterprise Server

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

Operating system versionFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
openSUSE Leap 15.6GitLab CE / GitLab EE 17.6.0x86_64, aarch64openSUSE installation documentationDec 2025openSUSE details
SUSE Linux Enterprise Server 12GitLab EE 9.0.0x86_64Use OpenSUSE installation documentationOct 2027SUSE Linux Enterprise Server details
SUSE Linux Enterprise Server 15GitLab EE 14.8.0x86_64Use OpenSUSE installation documentationDec 2024SUSE Linux Enterprise Server details

Oracle Linux

These versions of Oracle Linux are supported.

Operating systemFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
Oracle Linux 8GitLab CE / GitLab EE 12.8.1x86_64Use AlmaLinux installation documentationJuly 2029Oracle Linux details
Oracle Linux 9GitLab CE / GitLab EE 16.2.0x86_64Use AlmaLinux installation documentationJune 2032Oracle Linux details

Raspberry Pi OS

These versions of Raspberry Pi OS are supported.

Operating system versionFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
Raspberry Pi OS (Bullseye)GitLab CE 15.5.0armhfRaspberry Pi installation documentation2026Raspberry Pi details

Red Hat Enterprise Linux

These versions of Red Hat Enterprise Linux are supported.

Operating system versionFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
Red Hat Enterprise Linux 8GitLab CE / GitLab EE 12.8.1x86_64, arm64Use CentOS installation documentationMay 2029Red Hat Enterprise Linux details
Red Hat Enterprise Linux 9GitLab CE / GitLab EE 16.0.0x86_64, arm64Use CentOS installation documentationMay 2032Red Hat Enterprise Linux details

Ubuntu

These versions of Ubuntu are supported.

Operating systemFirst supported GitLab versionArchitectureInstallation documentationOperating system EOLDetails
Ubuntu 20.04GitLab CE / GitLab EE 13.2.0amd64, arm64Ubuntu installation documentationApril 2025Ubuntu details
Ubuntu 22.04GitLab CE / GitLab EE 15.5.0amd64, arm64Ubuntu installation documentationApril 2027Ubuntu details
Ubuntu 24.04GitLab CE / GitLab EE 17.1.0amd64, arm64Ubuntu installation documentationApril 2029Ubuntu details

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.

Known issues exist for running GitLab on ARM.

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:

OS versionEnd of lifeLast supported GitLab version
CentOS 6November 2020GitLab CE / GitLab EE 13.6
CentOS 7June 2024GitLab CE / GitLab EE 17.7
CentOS 8December 2021GitLab CE / GitLab EE 14.6
Oracle Linux 7December 2024GitLab CE / GitLab EE 17.7
Scientific Linux 7June 2024GitLab CE / GitLab EE 17.7
Debian 7 WheezyMay 2018GitLab CE / GitLab EE 11.6
Debian 8 JessieJune 2020GitLab CE / GitLab EE 13.3
Debian 9 StretchJune 2022GitLab CE / GitLab EE 15.2
Debian 10 BusterJune 2024GitLab CE / GitLab EE 17.5
OpenSUSE 42.1May 2017GitLab CE / GitLab EE 9.3
OpenSUSE 42.2January 2018GitLab CE / GitLab EE 10.4
OpenSUSE 42.3July 2019GitLab CE / GitLab EE 12.1
OpenSUSE 13.2January 2017GitLab CE / GitLab EE 9.1
OpenSUSE 15.0December 2019GitLab CE / GitLab EE 12.5
OpenSUSE 15.1November 2020GitLab CE / GitLab EE 13.12
OpenSUSE 15.2December 2021GitLab CE / GitLab EE 14.7
OpenSUSE 15.3December 2022GitLab CE / GitLab EE 15.10
OpenSUSE 15.4December 2023GitLab CE / GitLab EE 16.7
OpenSUSE 15.5December 2024GitLab CE / GitLab EE 17.8
Raspbian WheezyMay 2015GitLab CE 8.17
Raspbian JessieMay 2017GitLab CE 11.7
Raspbian StretchJune 2020GitLab CE 13.3
Raspberry Pi OS BusterJune 2024GitLab CE 17.7
Ubuntu 12.04April 2017GitLab CE / GitLab EE 9.1
Ubuntu 14.04April 2019GitLab CE / GitLab EE 11.10
Ubuntu 16.04April 2021GitLab CE / GitLab EE 13.12
Ubuntu 18.04June 2023GitLab CE / GitLab EE 16.11

An exception to this deprecation policy is when we are unable to provide packages for the next version of the operating system. The most common reason for this our package repository provider, PackageCloud, not supporting newer versions and hence we can’t upload packages to it.