- 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 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 supported OSs and their possible EOL dates.
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 Version | First supported GitLab version | Arch | Install Documentation | OS EOL | Details |
|---|---|---|---|---|---|
| AlmaLinux 8 | GitLab CE / GitLab EE 14.5.0 | x86_64, aarch64 | AlmaLinux Install Documentation | 2029 | https://almalinux.org/ |
| AlmaLinux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, aarch64 | AlmaLinux Install Documentation | 2032 | https://almalinux.org/ |
| CentOS 7 | GitLab CE / GitLab EE 7.10.0 | x86_64 | CentOS Install Documentation | June 2024 | https://www.centos.org/about/ |
| Debian 10 | GitLab CE / GitLab EE 12.2.0 | amd64, arm64 | Debian Install Documentation | 2024 | https://wiki.debian.org/LTS |
| Debian 11 | GitLab CE / GitLab EE 14.6.0 | amd64, arm64 | Debian Install Documentation | 2026 | https://wiki.debian.org/LTS |
| Debian 12 | GitLab CE / GitLab EE 16.1.0 | amd64, arm64 | Debian Install Documentation | TBD | https://wiki.debian.org/LTS |
| OpenSUSE 15.5 | GitLab CE / GitLab EE 16.4.0 | x86_64, aarch64 | OpenSUSE Install Documentation | Dec 2024 | https://en.opensuse.org/Lifetime |
| RHEL 8 | GitLab CE / GitLab EE 12.8.1 | x86_64, arm64 | Use CentOS Install Documentation | May 2029 | RHEL Details |
| RHEL 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, arm64 | Use CentOS Install Documentation | May 2032 | RHEL Details |
| SLES 12 | GitLab EE 9.0.0 | x86_64 | Use OpenSUSE Install Documentation | Oct 2027 | https://www.suse.com/lifecycle/ |
| SLES 15 | GitLab EE 14.8.0 | x86_64 | Use OpenSUSE Install Documentation | Dec 2024 | https://www.suse.com/lifecycle/ |
| Oracle Linux 7 | GitLab CE / GitLab EE 8.14.0 | x86_64 | Use CentOS Install Documentation | Dec 2024 | https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf |
| Oracle Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64 | Use AlmaLinux Install Documentation | July 2029 | https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf |
| Oracle Linux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64 | Use AlmaLinux Install Documentation | June 2032 | https://www.oracle.com/a/ocom/docs/elsp-lifetime-069338.pdf |
| Scientific Linux | GitLab CE / GitLab EE 8.14.0 | x86_64 | Use CentOS Install Documentation | June 2024 | https://scientificlinux.org/downloads/sl-versions/sl7/ |
| Ubuntu 20.04 | GitLab CE / GitLab EE 13.2.0 | amd64, arm64 | Ubuntu Install Documentation | April 2025 | https://wiki.ubuntu.com/Releases |
| Ubuntu 22.04 | GitLab CE / GitLab EE 15.5.0 | amd64, arm64 | Ubuntu Install Documentation | April 2027 | https://wiki.ubuntu.com/Releases |
| Ubuntu 24.04 | GitLab CE / GitLab EE 17.1.0 | amd64, arm64 | Ubuntu Install Documentation | April 2029 | https://wiki.ubuntu.com/Releases |
| Amazon Linux 2 | GitLab CE / GitLab EE 14.9.0 | amd64, arm64 | Amazon Linux 2 Install Documentation | June 2025 | https://aws.amazon.com/amazon-linux-2/faqs/ |
| Amazon Linux 2023 | GitLab CE / GitLab EE 16.3.0 | amd64, arm64 | Amazon Linux 2023 Install Documentation | 2028 | https://docs.aws.amazon.com/linux/al2023/ug/release-cadence.html |
| Raspberry Pi OS (Buster) (formerly known as Raspbian Buster) | GitLab CE 12.2.0 | armhf | Raspberry Pi Install Documentation | June 2024 | Raspberry Pi Details |
| Raspberry Pi OS (Bullseye) | GitLab CE 15.5.0 | armhf | Raspberry Pi Install Documentation | 2026 | Raspberry Pi Details |
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:
- 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.
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: