Install GitLab using the Linux package
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed
The Linux packages are mature, scalable, and are used on GitLab.com. If you need additional flexibility and resilience, we recommend deploying GitLab as described in the reference architecture documentation.
The Linux package is quicker to install, easier to upgrade, and contains features to enhance reliability not found in other installation methods. Install through a single package (also known as Omnibus GitLab) that bundles all the different services and tools required to run GitLab. You should have at least 4 GiB of RAM. For more information, see minimum requirements.
Linux packages are available in our packages repository for:
Check that the required GitLab version is available for your host operating system.
Supported platforms
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.
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.
| Operating system | First supported GitLab version | Architecture | Operating system EOL | Upstream release notes |
|---|---|---|---|---|
| AlmaLinux 8 | GitLab CE / GitLab EE 14.5.0 |
x86_64, aarch64 1
|
2029 | AlmaLinux details |
| AlmaLinux 9 | GitLab CE / GitLab EE 16.0.0 |
x86_64, aarch64 1
|
2032 | AlmaLinux details |
| Amazon Linux 2 | GitLab CE / GitLab EE 14.9.0 |
amd64, arm64 1
|
June 2026 | Amazon Linux details |
| Amazon Linux 2023 | GitLab CE / GitLab EE 16.3.0 |
amd64, arm64 1
|
2028 | Amazon Linux details |
| Debian 11 | GitLab CE / GitLab EE 14.6.0 |
amd64, arm64 1
|
2026 | Debian Linux details |
| Debian 12 | GitLab CE / GitLab EE 16.1.0 |
amd64, arm64 1
|
TBD | Debian Linux details |
| openSUSE Leap 15.6 | GitLab CE / GitLab EE 17.6.0 |
x86_64, aarch64 1
|
Dec 2025 | openSUSE details |
| SUSE Linux Enterprise Server 12 | GitLab EE 9.0.0 | x86_64 |
Oct 2027 | SUSE Linux Enterprise Server details |
| SUSE Linux Enterprise Server 15 | GitLab EE 14.8.0 | x86_64 |
Dec 2024 | SUSE Linux Enterprise Server details |
| Oracle Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64 |
July 2029 | Oracle Linux details |
| Oracle Linux 9 | GitLab CE / GitLab EE 16.2.0 | x86_64 |
June 2032 | Oracle Linux details |
| Red Hat Enterprise Linux 8 | GitLab CE / GitLab EE 12.8.1 |
x86_64, arm64 1
|
May 2029 | Red Hat Enterprise Linux details |
| Red Hat Enterprise Linux 9 | GitLab CE / GitLab EE 16.0.0 |
x86_64, arm64 1
|
May 2032 | Red Hat Enterprise Linux details |
| Ubuntu 20.04 | GitLab CE / GitLab EE 13.2.0 |
amd64, arm64 1
|
April 2025 | Ubuntu details |
| Ubuntu 22.04 | GitLab CE / GitLab EE 15.5.0 |
amd64, arm64 1
|
April 2027 | Ubuntu details |
| Ubuntu 24.04 | GitLab CE / GitLab EE 17.1.0 |
amd64, arm64 1
|
April 2029 | Ubuntu details |
Footnotes:
- Known issues exist for running GitLab on ARM.
Unofficial, unsupported installation methods
The following installation methods are provided as-is by the wider GitLab community and are not supported by GitLab:
- Debian native package (by Pirate Praveen)
- FreeBSD package (by Torsten Zühlsdorff)
- Arch Linux package (by the Arch Linux community)
- Puppet module (by Vox Pupuli)
- Ansible playbook (by Jeff Geerling)
- GitLab virtual appliance (KVM) (by OpenNebula)
- GitLab on Cloudron (via Cloudron App Library)
End-of-life versions
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 operating system even after it's EOL because we can't provide packages for a newer version. The most common reason for this is PackageCloud, our package repository provider, not supporting newer versions and so we can't upload packages to it.
The list of deprecated operating systems and the final GitLab release for them can be found below:
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, you 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.