debian-mirror-gitlab/doc/install/README.md

92 lines
4.5 KiB
Markdown
Raw Normal View History

2018-03-17 18:26:18 +05:30
---
comments: false
2018-11-08 19:23:39 +05:30
description: Read through the GitLab installation methods.
2019-09-04 21:01:54 +05:30
type: index
2018-03-17 18:26:18 +05:30
---
2019-09-30 21:07:59 +05:30
# Installation **(CORE ONLY)**
2014-09-02 18:07:02 +05:30
2019-02-15 15:39:39 +05:30
GitLab can be installed in most GNU/Linux distributions and in a number
2019-12-26 22:10:19 +05:30
of cloud providers. To get the best experience from GitLab, you need to balance
2019-02-15 15:39:39 +05:30
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:
2019-12-04 20:38:33 +05:30
1. **Omnibus GitLab**: The official deb/rpm packages that contain a bundle of GitLab
2020-05-24 23:13:21 +05:30
and the various components it depends on, like PostgreSQL, Redis, Sidekiq, etc.
2019-02-15 15:39:39 +05:30
1. **GitLab Helm chart**: The cloud native Helm chart for installing GitLab and all
its components on Kubernetes.
1. **Docker**: The Omnibus GitLab packages dockerized.
1. **Source**: Install GitLab and all its components from scratch.
TIP: **If in doubt, choose Omnibus:**
2020-05-24 23:13:21 +05:30
The Omnibus GitLab packages are mature,
[scalable](../administration/reference_architectures/index.md) and are used
2019-02-15 15:39:39 +05:30
today on GitLab.com. The Helm charts are recommended for those who are familiar
with Kubernetes.
2017-08-17 22:00:37 +05:30
## Requirements
2020-04-22 19:07:51 +05:30
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.
2017-08-17 22:00:37 +05:30
2019-02-15 15:39:39 +05:30
## Installing GitLab using the Omnibus GitLab package (recommended)
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
2020-05-24 23:13:21 +05:30
GitLab as described in our [reference architecture documentation](../administration/reference_architectures/index.md).
2019-02-15 15:39:39 +05:30
[**> Install GitLab using the Omnibus GitLab package.**](https://about.gitlab.com/install/)
## 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:
2017-08-17 22:00:37 +05:30
2019-02-15 15:39:39 +05:30
- 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.
2019-07-07 11:18:12 +05:30
- There are some feature [limitations to be aware of](https://docs.gitlab.com/charts/#limitations).
2017-08-17 22:00:37 +05:30
2019-07-07 11:18:12 +05:30
[**> Install GitLab on Kubernetes using the GitLab Helm charts.**](https://docs.gitlab.com/charts/)
2017-08-17 22:00:37 +05:30
2019-02-15 15:39:39 +05:30
## 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.**](docker.md)
## Installing GitLab from source
2020-05-24 23:13:21 +05:30
If the Omnibus GitLab package is not available in your distribution, you can
install GitLab from source: Useful for unsupported systems like \*BSD. For an
2019-02-15 15:39:39 +05:30
overview of the directory structure, read the [structure documentation](structure.md).
[**> Install GitLab from source.**](installation.md)
## 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.
- [Install on AWS](aws/index.md): Install Omnibus GitLab on AWS using the community AMIs that GitLab provides.
- [Install GitLab on Google Cloud Platform](google_cloud_platform/index.md): Install Omnibus GitLab on a VM in GCP.
- [Install GitLab on Azure](azure/index.md): Install Omnibus GitLab from Azure Marketplace.
2019-09-04 21:01:54 +05:30
- [Install GitLab on OpenShift](https://docs.gitlab.com/charts/installation/cloud/openshift.html): Install GitLab on OpenShift by using GitLab's Helm charts.
2019-12-21 20:55:43 +05:30
- [Install GitLab on DC/OS](https://d2iq.com/blog/gitlab-dcos): Install GitLab on Mesosphere DC/OS via the [GitLab-Mesosphere integration](https://about.gitlab.com/blog/2016/09/16/announcing-gitlab-and-mesosphere/).
- [Install GitLab on DigitalOcean](https://about.gitlab.com/blog/2016/04/27/getting-started-with-gitlab-and-digitalocean/): Install Omnibus GitLab on DigitalOcean.
2019-02-15 15:39:39 +05:30
- _Testing only!_ [DigitalOcean and Docker Machine](digitaloceandocker.md):
Quickly test any version of GitLab on DigitalOcean using Docker Machine.
2020-03-13 15:44:24 +05:30
## Securing your GitLab installation
After completing your installation, check out our [recommended practices to secure your GitLab instance](../security/README.md#securing-your-gitlab-installation).