How to Install and Configure GitLab on Ubuntu 18.04 LTS
This tutorial exists for these OS versions
- Ubuntu 18.04 (Bionic Beaver)
- Ubuntu 16.04 (Xenial Xerus)
On this page
- What we will do
- Step 1 - Update Repository and Upgrade Packages
- Step 2 - Install Gitlab Dependencies
- Step 3 - Install GitLab
- Step 4 - Generate Let's encrypt SSL Certificate and DHPARAM Certificate
- Step 5 - Configure HTTPS for GitLab
- Step 6 - Configure Ubuntu UFW Firewall
- Step 7 - GitLab Post-Installation
- Step 8 - Testing Gitlab
GitLab is an open source GIT repository manager based on Rails and developed by GitLab Inc. It is a web-based GIT repository manager that allows your team to work on code, perform feature requests, track bugs, and test and implement applications. GitLab provides features such as a wiki, issue tracking, code reviews, activity feeds, and merge management. It is able to host multiple projects.
GitLab is available in four editions:
- Gitlab CE (Community Edition) - self-hosted, free and support from the Community forum.
- Gitlab EE (Enterprise Edition) - self-hosted, paid app, comes with additional features.
- GitLab.com - SaaS, free.
- GitLab.io - Private GitLab instance managed by GitLab Inc.
In this tutorial, I will show you step-by-step how to install GitLab CE (Community Edition) on your own Ubuntu 18.04 LTS (Bionic Beaver) server. I will be using the 'omnibus' package provided by GitLab for easy installation.
- Ubuntu 18.04 Server
- Min RAM memory 4GB - for better performance, use 8GB
- Root privileges
What we will do
- Update Repository and Upgrade Packages
- Install Dependencies
- Install GitLab Community Edition
- Generate SSL Letsencrypt and DHPARAM Certificate
- Configure HTTPS for GitLab
- Configure Ubuntu UFW Firewall
- GitLab Post-Installation
Step 1 - Update Repository and Upgrade Packages
Before installing any packages on the system, update all available repositories and then upgrade all packages on the system.
Run apt commands below.
sudo apt update
sudo apt upgrade -y
Wait for the installation packages that will be upgraded.
Step 2 - Install Gitlab Dependencies
GitLab needs some packages dependencies for the installation, including curl, postfix, and ca-certificates.
Install GitLab packages dependencies using the apt command below.
sudo apt install curl openssh-server ca-certificates postfix -y
During postfix installation, you will be prompted about the configuration, select 'Internet Site'.
And then enter the server domain name that shall be used for sending an email.
And we're ready to install GitLab on the server.
Step 3 - Install GitLab
In this step, we will install GitLab using the omnibus packages. The Omnibus will install all packages, services, and tools required for running GitLab on the server.
Add GitLab repository with the curl command.
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
And then install GitLab CE Community Edition with the apt command.
sudo apt install gitlab-ce -y
The command will download and install the GitLab CE package, and when the installation is complete, you will see the results as below.
Next, we should configure the URL that will be used to access our GitLab server. We will be using a domain named 'git.hakase-labs.pw' for the GitLab access URL and will enable the HTTPS on it.
To change the GitLab URL access, edit the '/etc/gitlab/gitlab.rb' file.
sudo vim /etc/gitlab/gitlab.rb
Now change the 'external_url' value with your own domain name.
Save and exit.
Step 4 - Generate Let's encrypt SSL Certificate and DHPARAM Certificate
In this step, we will generate a new Letsencrypt certificate and DHPARAM certificate for the GitLab domain name 'git.hakase-labs.pw'.
Install the lets encrypt tool using the apt command below.
sudo apt install letsencrypt -y
And after the installation is complete, run the letsencrypt command below.
sudo letsencrypt certonly --standalone --agree-tos --no-eff-email --agree-tos --email [email protected] -d git.hakase-labs.pw
And when it's complete, you will get the result as shown below.
SSL Letsencrypt certificates have been generated, located in the '/etc/letsencyrpt/' directory.
Next, we will generate the DHPARAM certificate using the OpenSSL command.
Create a new directory '/etc/gitlab/ssl' and run the OpenSSL command below.
sudo mkdir -p /etc/gitlab/ssl/
sudo openssl dhparam -out /etc/gitlab/ssl/dhparams.pem 2048
Now change the permission of the SSL directory.
chmod 600 /etc/gitlab/ssl/*
And all certificates needed for GitLab HTTPS configuration have been generated.
Step 5 - Configure HTTPS for GitLab
In order to enable the HTTPS for GitLab installation, we need to edit the 'gitlab.rb' file.
Edit the '/etc/gitlab/gitlab.rb' file using the vim command below.
sudo vim /etc/gitlab/gitlab.rb
Change the 'external_url' of Gitlab to the 'https://git.hakase-labs.pw'.
Now paste configuration below to the '#GitLab Nginx' section.
nginx['redirect_http_to_https'] = true nginx['ssl_certificate'] = "/etc/letsencrypt/live/git.hakase-labs.pw/fullchain.pem" nginx['ssl_certificate_key'] = "/etc/letsencrypt/live/git.hakase-labs.pw/privkey.pem" nginx['ssl_dhparam'] = "/etc/gitlab/ssl/dhparams.pem"
Save and exit.
Now run the 'gitlab-ctl' command below.
sudo gitlab-ctl reconfigure
This command will install and configure GitLab based on the '/etc/gitlab/gitlab.rb' configuration file.
And when it's complete, you will see the result as below.
The GitLab installation is complete, and HTTPS for GitLab has been enabled.
Step 6 - Configure Ubuntu UFW Firewall
In this step, we will enable the Ubuntu UFW firewall. It's already installed on the system, we just need to start the service. We will run GitLab behind the Ubuntu UFW firewall, so we must open the HTTP and HTTPS ports.
Add ssh, http, and https services to the configuration.
sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
And enable the Ubuntu UFW firewall with the command below.
sudo ufw enable
Type 'y' for yes to enabled it.
Now check all services and ports list on the list.
sudo ufw status
And you will get ssh, http, and https services on the list.
Step 7 - GitLab Post-Installation
Open the web browser and type in the gitlab URL 'git.hakase-labs.pw', and you will be redirected to the HTTPS connection.
Create a New GitLab Root Password
Type your new password for root GitLab user, and click the 'Change your password' button.
Now Login as a 'root' user with your own password and click the 'Login' button.
Now you will get the GitLab Dashboard.
Click the profile button and choose 'Settings'.
On the 'Main Settings' section, type the profile name 'hakase' and then click the 'update profile settings' option.
Click the 'Account' tab and type the username 'hakase'.
Now press the 'Update username' button.
Add SSH Key
Generate a new key using the ssh-keygen command as below.
Copy the 'id_rsa.pub' key.
Now back to the GitLab user dashboard and click the 'SSH Key' menu on the left.
Paste the ssh public key 'id_rsa.pub' and click the 'Add key' button.
Sign up Restrictions
Click the 'Admin area' button on the middle, then click 'Settings'.
Uncheck the 'signup enabled' option and click the 'Save changes' button.
Click on the 'Account and limit' section and set the default project limit to 20.
And click the 'Save changes' button.
Step 8 - Testing Gitlab
Finally, we will do some tests to ensure that our GitLab system is working properly.
Create New Project
Click the plus icon on the top mid to create a new project repository. Type in your project name, description, and set up the visibility settings of your project. Then click on the 'Create project' button.
The new project has been created.
Test First Commit and Push
Now we will start adding new content to the repository. Make sure Git is installed on your computer, and we need to set up the global username and email for git with the command below.
git config --global user.name "hakase"
git config --global user.email "[email protected]"
Clone the Repository and add a README.md file.
git clone https://git.hakase-labs.pw/hakase/project01.git
You will be asked for the 'hakase' user password. Please type the same password that you used when we accessed GitLab the first time.
Commit a new file to the 'project01' repository.
git add .
git commit -m 'Add README.md file by hakase-labs'
Next, push the change to the repository on the GitLab server.
git push origin master
Type in your password and press Enter to continue. You will see the result as below.
Now open the 'project01' project from your web browser, and you will see that the new README.md file has been added to the repository.
GitLab installation guide on Ubuntu 18.04 has been completed successfully.