Install GitLab on Debian 10
GitLab® Community Edition, or GitLab CE, is an open-source web-based Git repository featuring
a wiki and issue tracking. This article describes how to install GitLab CE and configure
Secure Sockets Layer (SSL) on a Debian® 10 cloud server.
Prerequisites:
- A Debian 10 server with at least 8GB of RAM
- A domain name pointed at your server
Install dependencies
There are a few dependencies that you must install before you install GitLab.
First, at the command line, update your apt
cache with the following command:
sudo apt update
Then, install the ca-certificates
, curl
, openssh-server
, and postfix
packages:
sudo apt install ca-certificates curl openssh-server postfix
During the postfix installation, select Internet Site. On the next page, enter your domain name.
Install GitLab CE
After you finish installing the dependencies, perform the following steps:
-
Change directory to /tmp:
cd /tmp
-
Run the repository script from gitlab.com:
wget https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh
-
Install the repository by using the following command:
sudo bash script.deb.sh
-
Then, install GitLab CE:
sudo apt install gitlab-ce
Configure GitLab
After the command to install GitLab CE, you should see a warning about setting your domain name. While
fixing that, go ahead and enable SSL with letsencrypt
. Perform the following steps:
-
Open the GitLab configuration file with a text editor. This example uses
nano
.sudo nano /etc/gitlab/gitlab.rb
-
Find the
external_url field
and update it to match your domain name, changing http to https.
It should look similar to the following example:external_url 'https://example.com'
-
Look for the
letsencrypt[‘contact_emails’]
field. If there is ever a problem with your SSL
certificate, the system alerts the email addresses listed in this field. It should look similar
to the following example:letsencrypt['contact_emails'] = ['[email protected]']
-
Save the file and exit.
-
Reconfigure GitLab to have it read the new configuration file. This part may take a few minutes.
sudo gitlab-ctl reconfigure
After the reconfiguration finishes, navigate to your domain name in your web browser to start using GitLab CE.
Updated 12 months ago