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:
1.[**Omnibus GitLab**](#installing-gitlab-using-the-omnibus-gitlab-package-recommended): The official deb/rpm packages that contain a bundle of GitLab
and the various components it depends on, like PostgreSQL, Redis, Sidekiq, etc.
1.[**GitLab Helm chart**](#installing-gitlab-on-kubernetes-via-the-gitlab-helm-charts): The cloud native Helm chart for installing GitLab and all its components on Kubernetes.
1.[**Docker**](#installing-gitlab-with-docker): The Omnibus GitLab packages dockerized.
1.[**Source**](#installing-gitlab-from-source): Install GitLab and all its components from scratch.
1.[**Cloud provider**](#installing-gitlab-on-cloud-providers): Install directly from platforms like AWS, Azure, GCP.
TIP: **If in doubt, choose Omnibus:**
The Omnibus GitLab packages are mature,
[scalable](../administration/reference_architectures/index.md) and are used
GitLab can be installed in most GNU/Linux distributions and with several
cloud providers. To get the best experience from GitLab, you must balance
performance, reliability, ease of administration (backups, upgrades, and
troubleshooting), and the cost of hosting.
Depending on your platform, select from the following available methods to
If you're not sure which installation method to use, we recommend you use
Omnibus GitLab. The Omnibus GitLab packages are mature,
[scalable](../administration/reference_architectures/index.md), and are used
today on GitLab.com. The Helm charts are recommended for those who are familiar
with Kubernetes.
## Requirements
Before installing GitLab, it is of critical importance to review the system [requirements](requirements.md). The system requirements include details on the minimum hardware, software, database, and additional requirements to support GitLab.
Before you install GitLab, be sure to review the [system requirements](requirements.md).
The system requirements include details about the minimum hardware, software,
database, and additional requirements to support GitLab.
## Installing GitLab using the Omnibus GitLab package (recommended)
The Omnibus GitLab package uses our official deb/rpm repositories. This is
The Omnibus GitLab package uses our official deb/rpm repositories, and is
recommended for most users.
If you need additional flexibility and resilience, we recommend deploying
...
...
@@ -45,11 +54,6 @@ GitLab as described in our [reference architecture documentation](../administrat
## 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:
...
...
@@ -59,11 +63,17 @@ need to be aware of:
are deployed in a redundant fashion.
- There are some feature [limitations to be aware of](https://docs.gitlab.com/charts/#limitations).
Due to these trade-offs, having Kubernetes experience is a requirement for
using this method. 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.
[**> Install GitLab on Kubernetes using the GitLab Helm charts.**](https://docs.gitlab.com/charts/)
## Installing GitLab with Docker
GitLab maintains a set of official Docker images based on the Omnibus GitLab package.
GitLab maintains a set of official Docker images based on the Omnibus GitLab
package.
[**> Install GitLab using the official GitLab Docker images.**](docker.md)
