Installation

GitLab can be installed via various ways. Check the installation methods for an overview.

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.

Installation methods

• Installation using the Omnibus packages - Install GitLab using our official deb/rpm repositories. This is the recommended way.
• Installation from source - Install GitLab from source. Useful for unsupported systems like *BSD. For an overview of the directory structure, read the structure documentation.
• Docker - Install GitLab using Docker.

Install GitLab on cloud providers

• Installing in Kubernetes: Install GitLab into a Kubernetes Cluster using our official Helm Chart Repository.
• Install GitLab on OpenShift
• Install GitLab on DC/OS via GitLab-Mesosphere integration
• Install GitLab on Azure
• Install GitLab on Google Cloud Platform
• Install GitLab on Google Kubernetes Engine (GKE): video tutorial on the full process of installing GitLab on Google Kubernetes Engine (GKE), pushing an application to GitLab, building the app with GitLab CI/CD, and deploying to production.
• Install on AWS
• Testing only! DigitalOcean and Docker Machine - Quickly test any version of GitLab on DigitalOcean using Docker Machine.
• Getting started with GitLab and DigitalOcean: requirements, installation process, updates.
• Demo: Cloud Native Development with GitLab: video demonstration on how to install GitLab on Kubernetes, build a project, create Review Apps, store Docker images in Container Registry, deploy to production on Kubernetes, and monitor with Prometheus.

Database

While the recommended database is PostgreSQL, we provide information to install GitLab using MySQL. Check the MySQL documentation for more information.