Install GitLab using the Linux package
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed
The Linux packages are mature and 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 and easier to upgrade, and it 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. See the installation requirements to learn about the minimum hardware 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 provides Linux packages for the operating systems listed below. We build and distribute packages for these platforms. The table shows which GitLab versions are available for each operating system.
We provide Linux packages for operating systems based on vendor support lifecycles. Where long-term support (LTS) versions exist, we target those, though not all operating systems follow an LTS model.
Package builds typically continue until an operating system reaches vendor end-of-life (EOL). We follow standard or maintenance support timelines, not extended or premium support periods.
We may discontinue package builds before vendor EOL due to:
- Business considerations: Including but not limited to low customer adoption, disproportionate maintenance costs, or strategic product direction changes.
- Technical constraints: When third-party dependencies, security requirements, or underlying technology changes make continued package builds impractical or impossible.
- Vendor actions: When operating system vendors make changes that fundamentally impact our software’s functionality or when required components become unavailable.
We aim to provide at least 6 months’ notice before discontinuing support for any operating system version. When technical limitations or vendor constraints require shorter notice, we will communicate changes as soon as possible.
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 | Proposed last supported GitLab version | Upstream release notes |
|---|---|---|---|---|---|
| AlmaLinux 8 | GitLab CE / GitLab EE 14.5.0 | x86_64, aarch64 1 | Mar 2029 | GitLab CE / GitLab EE 21.10.0 | AlmaLinux details |
| AlmaLinux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, aarch64 1 | May 2032 | GitLab CE / GitLab EE 25.0.0 | AlmaLinux details |
| AlmaLinux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64, aarch64 1 | May 2035 | GitLab CE / GitLab EE 28.0.0 | AlmaLinux details |
| Amazon Linux 2 | GitLab CE / GitLab EE 14.9.0 | amd64, arm64 1 | June 2026 | GitLab CE / GitLab EE 19.1.0 | Amazon Linux details |
| Amazon Linux 2023 | GitLab CE / GitLab EE 16.3.0 | amd64, arm64 1 | June 2029 | GitLab CE / GitLab EE 22.1.0 | Amazon Linux details |
| Debian 11 | GitLab CE / GitLab EE 14.6.0 | amd64, arm64 1 | Aug 2026 | GitLab CE / GitLab EE 19.3.0 | Debian Linux details |
| Debian 12 | GitLab CE / GitLab EE 16.1.0 | amd64, arm64 1 | June 2028 | GitLab CE / GitLab EE 19.3.0 | Debian Linux details |
| Debian 13 | GitLab CE / GitLab EE 18.5.0 | amd64, arm64 1 | June 2030 | GitLab CE / GitLab EE 23.1.0 | Debian Linux details |
| openSUSE Leap 15.6 | GitLab CE / GitLab EE 17.6.0 | x86_64, aarch64 1 | Dec 2025 | TBD | openSUSE details |
| SUSE Linux Enterprise Server 12 | GitLab EE 9.0.0 | x86_64 | Oct 2027 | TBD | SUSE Linux Enterprise Server details |
| SUSE Linux Enterprise Server 15 | GitLab EE 14.8.0 | x86_64 | Dec 2024 | TBD | SUSE Linux Enterprise Server details |
| Oracle Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64 | July 2029 | GitLab CE / GitLab EE 22.2.0 | Oracle Linux details |
| Oracle Linux 9 | GitLab CE / GitLab EE 16.2.0 | x86_64 | June 2032 | GitLab CE / GitLab EE 25.1.0 | Oracle Linux details |
| Oracle Linux 10 | GitLab CE / GitLab EE 18.6.0 | x86_64 | June 2035 | GitLab CE / GitLab EE 28.1.0 | Oracle Linux details |
| Red Hat Enterprise Linux 8 | GitLab CE / GitLab EE 12.8.1 | x86_64, arm64 1 | May 2029 | GitLab CE / GitLab EE 22.0.0 | Red Hat Enterprise Linux details |
| Red Hat Enterprise Linux 9 | GitLab CE / GitLab EE 16.0.0 | x86_64, arm64 1 | May 2032 | GitLab CE / GitLab EE 25.0.0 | Red Hat Enterprise Linux details |