Download and install GitLab

Official Linux package (recommended installation)

Install via a single package (also known as Omnibus) that bundles all the different services and tools required to run GitLab

Ubuntu

16.04 LTS, 18.04 LTS, 20.04 LTS

1. Install and configure the necessary dependencies
```
sudo apt-get install -y curl openssh-server ca-certificates
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo apt-get install -y postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.
1. Install and configure the necessary dependencies
```
sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo apt-get install -y postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

Debian

9, 10

1. Install and configure the necessary dependencies
```
sudo apt-get install -y curl openssh-server ca-certificates
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo apt-get install -y postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.
1. Install and configure the necessary dependencies
```
sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo apt-get install -y postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

CentOS 8

and RHEL, Oracle, Scientific

1. Install and configure the necessary dependencies

On CentOS 8, the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo dnf install -y curl policycoreutils openssh-server openssh-clients
sudo systemctl enable sshd
sudo systemctl start sshd
# Check if opening the firewall is needed with: sudo systemctl status firewalld
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo dnf install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" dnf install -y gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.
1. Install and configure the necessary dependencies

On CentOS 8 (and RedHat 8), the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo dnf install -y curl policycoreutils openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd
# Check if opening the firewall is needed with: sudo systemctl status firewalld
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo dnf install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" dnf install -y gitlab-ee
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

CentOS 7

and RHEL, Oracle, Scientific

1. Install and configure the necessary dependencies

On CentOS 7, the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo yum install -y curl policycoreutils-python openssh-server openssh-clients
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.
1. Install and configure the necessary dependencies

On CentOS 7 (and RedHat/Oracle/Scientific Linux 7), the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo yum install -y curl policycoreutils-python openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ee
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

CentOS 6

and RHEL

1. Install and configure the necessary dependencies

On CentOS 6, the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo yum install -y curl policycoreutils-python openssh-server openssh-clients cronie
sudo lokkit -s http -s ssh
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo yum install postfix
sudo service postfix start
sudo chkconfig postfix on
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.
1. Install and configure the necessary dependencies

On CentOS 6 (and RedHat/Oracle/Scientific Linux 6), the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo yum install -y curl policycoreutils-python openssh-server cronie
sudo lokkit -s http -s ssh
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo yum install postfix
sudo service postfix start
sudo chkconfig postfix on
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" yum -y install gitlab-ee
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

OpenSUSE Leap 15.1

and SUSE Linux Enterprise Server 12.2, 12.5

1. Install and configure the necessary dependencies

On OpenSUSE, the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo zypper install curl openssh
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo zypper install postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.
1. Install and configure the necessary dependencies

On OpenSUSE, the commands below will also open HTTP, HTTPS and SSH access in the system firewall.
```
sudo zypper install curl openssh
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo zypper install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ee
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

Raspberry Pi OS

and Raspbian Buster

Raspberry Pi 4 with at least 4GB is recommended. Only 32bit (armhf) is supported at this point. 64 bit (aarch64) is on its way.

1. Install and configure the necessary dependencies
```
sudo apt-get install curl openssh-server ca-certificates apt-transport-https
curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
```
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
```
sudo apt-get install -y postfix
```
During Postfix installation a configuration screen may appear. Select 'Internet Site' and press enter. Use your server's external DNS for 'mail name' and press enter. If additional screens appear, continue to press enter to accept the defaults.

2. Add the GitLab package repository and install the package

Add the GitLab package repository.
```
sudo curl -sS https://packages.gitlab.com/install/repositories/gitlab/raspberry-pi2/script.deb.sh | sudo bash
```
Next, install the GitLab package. Change https://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.

For https:// URLs GitLab will automatically request a certificate with Let's Encrypt, which requires inbound HTTP access and a valid hostname. You can also use your own certificate or just use http://.
```
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ce
```
3. Browse to the hostname and login

On your first visit, you'll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account's username root to login.

See our documentation for detailed instructions on installing and configuration.

4. Set up your communication preferences

Visit our email subscription preference center to let us know when to communicate with you. We have an explicit email opt-in policy so you have complete control over what and how often we send you emails.

Twice a month, we send out the GitLab news you need to know, including new features, integrations, docs, and behind the scenes stories from our dev teams. For critical security updates related to bugs and system performance, sign up for our dedicated security newsletter.

Important note: If you do not opt-in to the security newsletter, you will not receive security alerts.

5. Configure sign-up restrictions and sign-in preferences.

After completing your installation, consider the recommended practices to secure your GitLab instance.

Helm install for Kubernetes

Kubernetes

Install GitLab using Helm charts

Supported cloud providers

Use the official Linux package to install GitLab in various cloud providers

Amazon Web Services (AWS)

Install GitLab on AWS

Google Cloud Platform (GCP)

Install GitLab on GCP

Microsoft Azure

Install GitLab on Azure

Other official installation methods

Docker

Official GitLab Docker Images

Installation from source

Install GitLab using the source files on a Debian/Ubuntu system

Unofficial, community-contributed installation methods

Debian native package

by Pirate Praveen

FreeBSD package

by Torsten Zühlsdorff

Arch Linux package

by the Arch Linux community

Puppet module

by Vox Pupuli

Ansible playbook

by Jeff Geerling

IBM Cloud (Bluemix)

by IBM

GitLab HA for Linux on Z

by IBM

GitLab recipes

Using GitLab with different software

GitLab on Univention Corporate Server

via App Center by Univention

GitLab China Mirror

by Shanghai C&S Information Technology (上海创实), GitLab's official reseller in China

GitLab virtual appliance (KVM)

by OpenNebula

GitLab on Cloudron

via Cloudron App Library

Update from an old version of GitLab

Update to the latest release of GitLab

Upgrade from GitLab Community Edition

Upgrade to Enterprise Edition

Upgrade from manually installed Omnibus package

Upgrade to Omnibus package repository

Third-party applications that support GitLab

View third-party applications

Install self-managed GitLab

Try GitLab Ultimate for 30 days!

Official Linux package (recommended installation)

Ubuntu

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

Debian

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

CentOS 8

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

CentOS 7

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

CentOS 6

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

OpenSUSE Leap 15.1

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

Raspberry Pi OS

1. Install and configure the necessary dependencies

2. Add the GitLab package repository and install the package

3. Browse to the hostname and login

4. Set up your communication preferences

5. Configure sign-up restrictions and sign-in preferences.

Helm install for Kubernetes

Kubernetes

Supported cloud providers

Amazon Web Services (AWS)

Google Cloud Platform (GCP)