Installation [CORE ONLY]

GitLab can be installed in most GNU/Linux distributions and in a number
of cloud providers. To get the best experience from GitLab you need to balance
performance, reliability, ease of administration (backups, upgrades and troubleshooting),
and cost of hosting.

There are many ways you can install GitLab depending on your platform:

Omnibus Gitlab: The official deb/rpm packages that contain a bundle of GitLab
and the various components it depends on like PostgreSQL, Redis, Sidekiq, etc.

GitLab Helm chart: The cloud native Helm chart for installing GitLab and all
its components on Kubernetes.

Docker: The Omnibus GitLab packages dockerized.

Source: Install GitLab and all its components from scratch.

TIP: If in doubt, choose Omnibus:
The Omnibus GitLab packages are mature, scalable, support
high availability and are used
today on GitLab.com. The Helm charts are recommended for those who are familiar
with Kubernetes.

Requirements

Before installing GitLab, make sure to check the requirements documentation
which includes useful information on the supported Operating Systems as well as
the hardware requirements.

Installing GitLab using the Omnibus GitLab package (recommended)

The Omnibus GitLab package uses our official deb/rpm repositories. This is
recommended for most users.

Installing GitLab on Kubernetes via the GitLab Helm charts

NOTE: Kubernetes experience required:
We recommend being familiar with Kubernetes before using it to deploy GitLab in
production. The methods for management, observability, and some concepts are
different than traditional deployments.

When installing GitLab on Kubernetes, there are some trade-offs that you
need to be aware of:

Administration and troubleshooting requires Kubernetes knowledge.

It can be more expensive for smaller installations. The default installation
requires more resources than a single node Omnibus deployment, as most services
are deployed in a redundant fashion.

Installing GitLab with Docker

Installing GitLab from source

If the GitLab Omnibus package is not available in your distribution, you can
install GitLab from source: Useful for unsupported systems like *BSD. For an
overview of the directory structure, read the structure documentation.