Install GitLab on Ubuntu 18.04
Last updated on: 2020-07-28
Authored by: Rackspace Support
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 an Ubuntu® 18.04 LTS cloud server.
- A server with at least 8GB of ram
- A domain name pointed at your server
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
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:
Run the repository script from gitlab.com:
Install the repository by using the following command:
sudo bash script.deb.sh
Then, install GitLab CE:
sudo apt install gitlab-ce
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
sudo nano /etc/gitlab/gitlab.rb
external_url fieldand update it to match your domain name, changing http to https. It should look similar to the following example:
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'] = ['firstname.lastname@example.org']
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.