gitlab-org--gitlab-foss/doc/install
Marcia Ramos 14cf8bf050 Merge branch 'docs/point-to-new-chart-links' into 'master'
Redirect Kubernetes installation to the charts docs

Closes #58870

See merge request gitlab-org/gitlab-ce!26159
2019-04-05 10:56:38 +00:00
..
aws Update AWS install docs for non HA 2019-03-27 07:37:48 +00:00
azure Ensure all lists are surrounded by new lines 2019-02-22 13:17:10 +00:00
google_cloud_platform Fix most instances of bare URLs in markdown 2019-01-24 06:52:33 +00:00
kubernetes Redirect Kubernetes installation to the charts docs 2019-03-19 14:10:44 +01:00
openshift_and_gitlab Fix some 404 links into charts project 2019-03-01 19:11:29 +00:00
database_mysql.md Docs: Cleaning up various links 2018-11-21 23:15:01 +00:00
digitaloceandocker.md Improve markdown and fix links that don't render correctly 2018-11-01 12:57:41 +10:00
docker.md Minor grammar fix in docker.md 2019-02-28 11:20:39 +00:00
google-protobuf.md Instructions for installing google-protobuf from source 2017-03-09 15:05:40 +01:00
installation.md bin/background_jobs: use pgroups 2019-02-28 21:58:31 +00:00
README.md Redirect Kubernetes installation to the charts docs 2019-03-19 14:10:44 +01:00
redis.md Fix Redis installation guide 2016-02-16 21:32:22 +02:00
relative_url.md Correct grammar (setup to set-up) in Docs 2018-09-21 16:29:14 +02:00
requirements.md Update browser requirements to be clear about minor versions. 2019-03-06 12:26:51 +00:00
structure.md Make unordered lists conform to styleguide 2019-01-08 12:21:09 +10:00

comments description
false Read through the GitLab installation methods.

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:

  1. 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.
  2. GitLab Helm chart: The cloud native Helm chart for installing GitLab and all its components on Kubernetes.
  3. Docker: The Omnibus GitLab packages dockerized.
  4. 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.

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

If you need additional flexibility and resilience, we recommend deploying GitLab as described in our High Availability documentation.

> Install GitLab using the Omnibus GitLab package.

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.
  • There are some feature limitations to be aware of.

> Install GitLab on Kubernetes using the GitLab Helm charts.

Installing GitLab with Docker

GitLab maintains a set of official Docker images based on the Omnibus GitLab package.

> Install GitLab using the official GitLab Docker images.

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.

> Install GitLab from source.

Installing GitLab on cloud providers

GitLab can be installed on a variety of cloud providers by using any of the above methods, provided the cloud provider supports it.