debian-mirror-gitlab/doc/administration/package_information/supported_os.md
2022-08-27 11:52:29 +05:30

13 KiB

stage group info
Systems Distribution To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Supported operating systems (FREE SELF)

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.

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/
CentOS 7 GitLab CE / GitLab EE 7.10.0 x86_64 CentOS Install Documentation June 2024 https://wiki.centos.org/About/Product
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
OpenSUSE 15.3 GitLab CE / GitLab EE 14.5.0 x86_64, aarch64 OpenSUSE Install Documentation Nov 2022 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
SLES 12 GitLab EE 9.0.0 x86_64 Use OpenSUSE Install Documentation Oct 2027 https://www.suse.com/lifecycle/
Oracle Linux GitLab CE / GitLab EE 8.14.0 x86_64 Use CentOS Install Documentation Jul 2024 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 18.04 GitLab CE / GitLab EE 10.7.0 amd64 Ubuntu Install Documentation April 2023 https://wiki.ubuntu.com/Releases
Ubuntu 20.04 GitLab CE / GitLab EE 13.2.0 amd64, arm64 Ubuntu Install Documentation April 2025 https://wiki.ubuntu.com/Releases
Amazon Linux 2 GitLab CE / GitLab EE 14.9.0 amd64, arm64 Amazon Linux 2 Install Documentation June 2023 https://aws.amazon.com/amazon-linux-2/faqs/
Raspberry Pi OS (Buster) (formerly known as Raspbian Buster) GitLab CE 12.2.0 armhf Raspberry Pi Install Documentation 2024 Raspberry 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.

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.

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.

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

OS Versions that are no longer supported

GitLab provides omnibus 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 Version End Of Life Last supported GitLab version
Raspbian Wheezy May 2015 GitLab CE 8.17
OpenSUSE 13.2 January 2017 GitLab CE / GitLab EE 9.1
Ubuntu 12.04 April 2017 GitLab CE / GitLab EE 9.1
OpenSUSE 42.1 May 2017 GitLab CE / GitLab EE 9.3
OpenSUSE 42.2 January 2018 GitLab CE / GitLab EE 10.4
Debian Wheezy May 2018 GitLab CE / GitLab EE 11.6
Raspbian Jessie May 2017 GitLab CE 11.7
Ubuntu 14.04 April 2019 GitLab CE / GitLab EE 11.10
OpenSUSE 42.3 July 2019 GitLab CE / GitLab EE 12.1
OpenSUSE 15.0 December 2019 GitLab CE / GitLab EE 12.5
Raspbian Stretch June 2020 GitLab CE 13.3
Debian Jessie June 2020 GitLab CE / GitLab EE 13.3
CentOS 6 November 2020 GitLab CE / GitLab EE 13.6
CentOS 8 December 2021 GitLab CE / GitLab EE 14.6
OpenSUSE 15.1 November 2020 GitLab CE / GitLab EE 13.12
Ubuntu 16.04 April 2021 GitLab CE / GitLab EE 13.12
OpenSUSE 15.2 December 2021 GitLab CE / GitLab EE 14.7
Debian 9 "Stretch" June 2022 GitLab CE / GitLab EE 15.2

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.