Supported operating systems
DETAILS: Tier: Free, Premium, Ultimate Offering: 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.
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.
AlmaLinux
These versions of AlmaLinux are supported.
| Operating system | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| AlmaLinux 8 | GitLab CE / GitLab EE 14.5.0 |
x86_64, aarch64
|
AlmaLinux installation documentation | 2029 | AlmaLinux details |
| AlmaLinux 9 | GitLab CE / GitLab EE 16.0.0 |
x86_64, aarch64
|
AlmaLinux installation documentation | 2032 | AlmaLinux details |
Amazon Linux
These versions of Amazon Linux are supported.
| Operating system | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| Amazon Linux 2 | GitLab CE / GitLab EE 14.9.0 |
amd64, arm64
|
Amazon Linux 2 installation documentation | June 2025 | Amazon Linux details |
| Amazon Linux 2023 | GitLab CE / GitLab EE 16.3.0 |
amd64, arm64
|
Amazon Linux 2023 installation documentation | 2028 | Amazon Linux details |
CentOS and Scientific Linux
These versions of CentOS and Scientific Linux are supported.
| Operating system | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| CentOS 7 | GitLab CE / GitLab EE 7.10.0 | x86_64 |
CentOS installation documentation | June 2024 | CentOS Linux details |
| Scientific Linux | GitLab CE / GitLab EE 8.14.0 | x86_64 |
Use CentOS installation documentation | June 2024 | Scientific Linux details |
Debian
These versions of Debian are supported.
| Operating system | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| Debian 11 | GitLab CE / GitLab EE 14.6.0 |
amd64, arm64
|
Debian installation documentation | 2026 | Debian Linux details |
| Debian 12 | GitLab CE / GitLab EE 16.1.0 |
amd64, arm64
|
Debian installation documentation | TBD | Debian Linux details |
openSUSE Leap and SUSE Linux Enterprise Server
These versions of openSUSE Leap and SUSE Linux Enterprise Server are supported.
| Operating system version | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| openSUSE Leap 15.5 | GitLab CE / GitLab EE 16.4.0 |
x86_64, aarch64
|
openSUSE installation documentation | Dec 2024 | openSUSE details |
| SUSE Linux Enterprise Server 12 | GitLab EE 9.0.0 | x86_64 |
Use OpenSUSE installation documentation | Oct 2027 | SUSE Linux Enterprise Server details |
| SUSE Linux Enterprise Server 15 | GitLab EE 14.8.0 | x86_64 |
Use OpenSUSE installation documentation | Dec 2024 | SUSE Linux Enterprise Server details |
Oracle Linux
These versions of Oracle Linux are supported.
| Operating system | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| Oracle Linux 7 | GitLab CE / GitLab EE 8.14.0 | x86_64 |
Use CentOS installation documentation | Dec 2024 | Oracle Linux details |
| Oracle Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64 |
Use AlmaLinux installation documentation | July 2029 | Oracle Linux details |
| Oracle Linux 9 | GitLab CE / GitLab EE 16.2.0 | x86_64 |
Use AlmaLinux installation documentation | June 2032 | Oracle Linux details |
Raspberry Pi OS
These versions of Raspberry Pi OS are supported.
| Operating system version | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| Raspberry Pi OS (Buster) (formerly known as Raspbian Buster) | GitLab CE 12.2.0 | armhf |
Raspberry Pi installation documentation | June 2024 | Raspberry Pi details |
| Raspberry Pi OS (Bullseye) | GitLab CE 15.5.0 | armhf |
Raspberry Pi installation documentation | 2026 | Raspberry Pi details |
Red Hat Enterprise Linux
These versions of Red Hat Enterprise Linux are supported.
| Operating system version | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| Red Hat Enterprise Linux 8 | GitLab CE / GitLab EE 12.8.1 |
x86_64, arm64
|
Use CentOS installation documentation | May 2029 | Red Hat Enterprise Linux details |
| Red Hat Enterprise Linux 9 | GitLab CE / GitLab EE 16.0.0 |
x86_64, arm64
|
Use CentOS installation documentation | May 2032 | Red Hat Enterprise Linux details |
Ubuntu
These versions of Ubuntu are supported.
| Operating system | First supported GitLab version | Architecture | Installation documentation | Operating system EOL | Details |
|---|---|---|---|---|---|
| Ubuntu 20.04 | GitLab CE / GitLab EE 13.2.0 |
amd64, arm64
|
Ubuntu installation documentation | April 2025 | Ubuntu details |
| Ubuntu 22.04 | GitLab CE / GitLab EE 15.5.0 |
amd64, arm64
|
Ubuntu installation documentation | April 2027 | Ubuntu details |
| Ubuntu 24.04 | GitLab CE / GitLab EE 17.1.0 |
amd64, arm64
|
Ubuntu installation documentation | April 2029 | Ubuntu 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:
- Upgrade the OS.
- Check if it's necessary to update the GitLab package sources.
- 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.
WARNING: 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:
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.