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

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 AlmaLinux installation documentationMay 2029Red Hat Enterprise Linux details
Red Hat Enterprise Linux 9GitLab CE / GitLab EE 16.0.0x86_64, arm64Use AlmaLinux 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

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.

However, sometimes, we don’t deprecate an OS even after it’s EOL, because we can’t provide packages for a newer version to the users yet. The most common reason for this is that our package repository provider, PackageCloud, not supporting newer versions, and hence we can’t upload packages to it.

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 6 and RHEL 6November 2020GitLab CE / GitLab EE 13.6
CentOS 7 and RHEL 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

Raspberry Pi OS (32-bit - Raspbian)

GitLab dropped support for Raspberry Pi OS (32 bit - Raspbian) with GitLab 17.11 being the last version available for the 32-bit platform. Starting with GitLab 18.0, users should move to Raspberry Pi OS (64 bit) and use the Debian arm64 package.

For information on backing up data on a 32-bit OS and restoring it to a 64-bit OS, see Upgrading operating systems for PostgreSQL.