Supported operating systems

GitLab officially supports LTS versions of operating systems. While OSs like Ubuntu have a clear distinction between LTS and non-LTS versions, there are other OSs, openSUSE for example, that don’t follow the LTS concept. Hence to avoid confusion, the official policy is that at any point of time, all the operating systems supported by GitLab are listed in the installation page.

The following lists the currently supported OSs and their possible EOL dates.

note
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.
OS VersionFirst supported GitLab versionArchInstall DocumentationOS EOLDetails
AlmaLinux 8GitLab CE / GitLab EE 14.5.0x86_64, aarch64AlmaLinux Install Documentation2029https://almalinux.org/
AlmaLinux 9GitLab CE / GitLab EE 16.0.0x86_64, aarch64AlmaLinux Install Documentation2032https://almalinux.org/
CentOS 7GitLab CE / GitLab EE 7.10.0x86_64CentOS Install DocumentationJune 2024https://wiki.centos.org/About/Product
Debian 10GitLab CE / GitLab EE 12.2.0amd64, arm64Debian Install Documentation2024https://wiki.debian.org/LTS
Debian 11GitLab CE / GitLab EE 14.6.0amd64, arm64Debian Install Documentation2026https://wiki.debian.org/LTS
OpenSUSE 15.4GitLab CE / GitLab EE 15.7.0x86_64, aarch64OpenSUSE Install DocumentationNov 2023https://en.opensuse.org/Lifetime
OpenSUSE 15.5GitLab CE / GitLab EE 16.4.0x86_64, aarch64OpenSUSE Install DocumentationDec 2024https://en.opensuse.org/Lifetime
RHEL 8GitLab CE / GitLab EE 12.8.1x86_64, arm64Use CentOS Install DocumentationMay 2029RHEL Details
RHEL 9GitLab CE / GitLab EE 16.0.0x86_64, arm64Use CentOS Install DocumentationMay 2032RHEL Details
SLES 12GitLab EE 9.0.0x86_64Use OpenSUSE Install DocumentationOct 2027https://www.suse.com/lifecycle/
SLES 15GitLab EE 14.8.0x86_64Use OpenSUSE Install DocumentationDec 2024https://www.suse.com/lifecycle/
Oracle Linux 7GitLab CE / GitLab EE 8.14.0x86_64Use CentOS Install DocumentationDec 2024https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf
Scientific LinuxGitLab CE / GitLab EE 8.14.0x86_64Use CentOS Install DocumentationJune 2024https://scientificlinux.org/downloads/sl-versions/sl7/
Ubuntu 18.04GitLab CE / GitLab EE 10.7.0amd64Ubuntu Install DocumentationApril 2023https://wiki.ubuntu.com/Releases
Ubuntu 20.04GitLab CE / GitLab EE 13.2.0amd64, arm64Ubuntu Install DocumentationApril 2025https://wiki.ubuntu.com/Releases
Ubuntu 22.04GitLab CE / GitLab EE 15.5.0amd64, arm64Ubuntu Install DocumentationApril 2027https://wiki.ubuntu.com/Releases
Amazon Linux 2GitLab CE / GitLab EE 14.9.0amd64, arm64Amazon Linux 2 Install DocumentationJune 2025https://aws.amazon.com/amazon-linux-2/faqs/
Amazon Linux 2023GitLab CE / GitLab EE 16.3.0amd64, arm64Amazon Linux 2023 Install Documentation2028https://docs.aws.amazon.com/linux/al2023/ug/release-cadence.html
Raspberry Pi OS (Buster) (formerly known as Raspbian Buster)GitLab CE 12.2.0armhfRaspberry Pi Install DocumentationJune 2024Raspberry Pi Details
Raspberry Pi OS (Bullseye)GitLab CE 15.5.0armhfRaspberry Pi Install Documentation2026Raspberry Pi Details
note
CentOS 8 was EOL on December 31, 2021. In GitLab 14.5 and later, CentOS builds work in AlmaLinux. We officially support all distributions that are binary compatible with Red Hat Enterprise Linux. This gives users a path forward for their CentOS 8 builds at its end of life.
note
The CentOS major version and a minor version up to CentOS8 (when CentOS Stream was released) correspond to the set of major version and update versions of RHEL.

Update GitLab package sources after upgrading the OS

After upgrading the Operating System (OS) as per its own documentation, it may be necessary to also update the GitLab package source URL in your package manager configuration. If your package manager reports that no further updates are available, although new versions have been released, repeat the “Add the GitLab package repository” instructions of the Linux package install guide. Future GitLab upgrades are fetched according to your upgraded OS.

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.

Packages for ARM64

Introduced in GitLab 13.4.

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

caution
There are currently still some known issues and limitation running GitLab on ARM.

OS Versions that are no longer supported

GitLab provides Linux packages for operating systems only until their EOL (End-Of-Life). After the EOL date of the OS, 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
Raspbian WheezyMay 2015 GitLab CE 8.17
OpenSUSE 13.2January 2017 GitLab CE / GitLab EE 9.1
Ubuntu 12.04April 2017 GitLab CE / GitLab EE 9.1
OpenSUSE 42.1May 2017 GitLab CE / GitLab EE 9.3
OpenSUSE 42.2January 2018 GitLab CE / GitLab EE 10.4
Debian WheezyMay 2018 GitLab CE / GitLab EE 11.6
Raspbian JessieMay 2017 GitLab CE 11.7
Ubuntu 14.04April 2019 GitLab CE / GitLab EE 11.10
OpenSUSE 42.3July 2019 GitLab CE / GitLab EE 12.1
OpenSUSE 15.0December 2019 GitLab CE / GitLab EE 12.5
Raspbian StretchJune 2020 GitLab CE 13.3
Debian JessieJune 2020 GitLab CE / GitLab EE 13.3
CentOS 6November 2020 GitLab CE / GitLab EE 13.6
CentOS 8December 2021 GitLab CE / GitLab EE 14.6
OpenSUSE 15.1November 2020 GitLab CE / GitLab EE 13.12
Ubuntu 16.04April 2021 GitLab CE / GitLab EE 13.12
OpenSUSE 15.2December 2021 GitLab CE / GitLab EE 14.7
Debian 9 “Stretch”June 2022 GitLab CE / GitLab EE 15.2
OpenSUSE 15.3December 2022 GitLab CE / GitLab EE 15.10
note
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.