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.<\/p>\n
Prerequisites<\/h2>\n\n- Ubuntu 18.04 Server<\/li>\n
- Min RAM memory 4GB – for better performance, use 8GB<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do<\/h2>\n\n- Update Repository and Upgrade Packages<\/li>\n
- Install Dependencies<\/li>\n
- Install GitLab Community Edition<\/li>\n
- Generate SSL Letsencrypt and DHPARAM Certificate<\/li>\n
- Configure HTTPS for GitLab<\/li>\n
- Configure Ubuntu UFW Firewall<\/li>\n
- GitLab Post-Installation<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Update Repository and Upgrade Packages<\/h2>\n
Before installing any packages on the system, update all available repositories and then upgrade all packages on the system.<\/p>\n
Run apt commands below.<\/p>\n
sudo apt update
sudo apt upgrade -y<\/p>\n
Wait for the installation packages that will be upgraded.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install Gitlab Dependencies<\/h2>\n
GitLab needs some packages dependencies for the installation, including curl, postfix, and ca-certificates.<\/p>\n
Install GitLab packages dependencies using the apt command below.<\/p>\n
sudo apt install curl openssh-server ca-certificates postfix -y<\/p>\n
During postfix installation, you will be prompted about the configuration, select ‘Internet Site’.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-1.png\" "\\"\\"")
<\/a><\/p>\nAnd then enter the server domain name that shall be used for sending an email.<\/p>\n
![\"Enter](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-2.png\" "\\"\\"")
<\/a><\/p>\nAnd we’re ready to install GitLab on the server.<\/p>\n
Step 3 – Install GitLab<\/h2>\n
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.<\/p>\n
Add GitLab repository with the curl command.<\/p>\n
curl -sS https:\/\/packages.gitlab.com\/install\/repositories\/gitlab\/gitlab-ce\/script.deb.sh | sudo bash<\/p>\n
![\"Download](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-3.png\" "\\"\\"")
<\/a><\/p>\nAnd then install GitLab CE Community Edition with the apt command.<\/p>\n
sudo apt install gitlab-ce -y<\/p>\n
The command will download and install the GitLab CE package, and when the installation is complete, you will see the results as below.<\/p>\n
![\"Gitlab](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-4.png\" "\\"\\"")
<\/a><\/p>\nNext, 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.<\/p>\n
To change the GitLab URL access, edit the ‘\/etc\/gitlab\/gitlab.rb’ file.<\/p>\n
sudo vim \/etc\/gitlab\/gitlab.rb<\/p>\n
Now change the ‘external_url’ value with your own domain name.<\/p>\n
external_url 'http:\/\/git.hakase-labs.pw'<\/pre>\nSave and exit.<\/p>\n
Step 4 – Generate Let’s encrypt SSL Certificate and DHPARAM Certificate<\/h2>\n
In this step, we will generate a new Letsencrypt certificate and DHPARAM certificate for the GitLab domain name ‘git.hakase-labs.pw’.<\/p>\n
Install the lets encrypt tool using the apt command below.<\/p>\n
sudo apt install letsencrypt -y<\/p>\n
And after the installation is complete, run the letsencrypt command below.<\/p>\n
sudo letsencrypt certonly –standalone –agree-tos –no-eff-email –agree-tos –email [email\u00a0protected]<\/a> -d git.hakase-labs.pw<\/p>\nAnd when it’s complete, you will get the result as shown below.<\/p>\n
![\"Get](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-5.png\" "\\"\\"")
<\/a><\/p>\nSSL Letsencrypt certificates have been generated, located in the ‘\/etc\/letsencyrpt\/’ directory.<\/p>\n
Next, we will generate the DHPARAM certificate using the OpenSSL command.<\/p>\n
Create a new directory ‘\/etc\/gitlab\/ssl’ and run the OpenSSL command below.<\/p>\n
sudo mkdir -p \/etc\/gitlab\/ssl\/
sudo openssl dhparam -out \/etc\/gitlab\/ssl\/dhparams.pem 2048<\/p>\n
Now change the permission of the SSL directory.<\/p>\n
chmod 600 \/etc\/gitlab\/ssl\/*<\/p>\n
![\"Get](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-6.png\" "\\"\\"")
<\/a><\/p>\nAnd all certificates needed for GitLab HTTPS configuration have been generated.<\/p>\n
Step 5 – Configure HTTPS for GitLab<\/h2>\n
In order to enable the HTTPS for GitLab installation, we need to edit the ‘gitlab.rb’ file.<\/p>\n
Edit the ‘\/etc\/gitlab\/gitlab.rb’ file using the\u00a0vim command<\/a> below.<\/p>\nsudo vim \/etc\/gitlab\/gitlab.rb<\/p>\n
Change the ‘external_url’ of Gitlab to the ‘https:\/\/git.hakase-labs.pw’.<\/p>\n
external_url 'https:\/\/git.hakase-labs.pw'<\/pre>\nNow paste configuration below to the ‘#GitLab Nginx’ section.<\/p>\n
nginx['redirect_http_to_https'] = true
\nnginx['ssl_certificate'] = \"\/etc\/letsencrypt\/live\/git.hakase-labs.pw\/fullchain.pem\"
\nnginx['ssl_certificate_key'] = \"\/etc\/letsencrypt\/live\/git.hakase-labs.pw\/privkey.pem\"
\nnginx['ssl_dhparam'] = \"\/etc\/gitlab\/ssl\/dhparams.pem\"<\/pre>\nSave and exit.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-7.png\" "\\"\\"")
<\/a><\/p>\nNow run the ‘gitlab-ctl’ command below.<\/p>\n
sudo gitlab-ctl reconfigure<\/p>\n
This command will install and configure GitLab based on the ‘\/etc\/gitlab\/gitlab.rb’ configuration file.<\/p>\n
And when it’s complete, you will see the result as below.<\/p>\n
![\"Restart](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-8.png\" "\\"\\"")
<\/a><\/p>\nThe GitLab installation is complete, and HTTPS for GitLab has been enabled.<\/p>\n
Step 6 – Configure Ubuntu UFW Firewall<\/h2>\n
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.<\/p>\n
Add ssh, http, and https services to the configuration.<\/p>\n
sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https<\/p>\n
And enable the Ubuntu UFW firewall with the command below.<\/p>\n
sudo ufw enable<\/p>\n
Type ‘y’ for yes to enabled it.<\/p>\n
Now check all services and ports list on the list.<\/p>\n
sudo ufw status<\/p>\n
And you will get ssh, http, and https services on the list.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-9.png\" "\\"\\"")
<\/a><\/p>\nStep 7 – GitLab Post-Installation<\/h2>\n
Open the web browser and type in the gitlab URL ‘git.hakase-labs.pw’, and you will be redirected to the HTTPS connection.<\/p>\n
Create a New GitLab Root Password<\/h3>\n
Type your new password for root GitLab user, and click the ‘Change your password’ button.<\/p>\n
![\"Set](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-10.png\" "\\"\\"")
<\/a><\/p>\nNow Login as a ‘root’ user with your own password and click the ‘Login’ button.<\/p>\n
![\"Log](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-11.png\" "\\"\\"")
<\/a><\/p>\nNow you will get the GitLab Dashboard.<\/p>\n
![\"Gitlab](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-12.png\" "\\"\\"")
<\/a><\/p>\nChange Profile<\/h3>\n
Click the profile button and choose ‘Settings’.<\/p>\n
![\"Change](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-13.png\" "\\"\\"")
<\/a><\/p>\nOn the ‘Main Settings’ section, type the profile name ‘hakase’ and then click the ‘update profile settings’ option.<\/p>\n
Change Username<\/h3>\n
Click the ‘Account’ tab and type the username ‘hakase’.<\/p>\n
![\"Change](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-14.png\" "\\"\\"")
<\/a><\/p>\nNow press the ‘Update username’ button.<\/p>\n
Add SSH Key<\/h3>\n
Generate a new key using the ssh-keygen command as below.<\/p>\n
ssh-keygen
cat ~\/.ssh\/id_rsa.pub<\/p>\n
Copy the ‘id_rsa.pub’ key.<\/p>\n
![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-15.png\" "\\"\\"")
<\/a><\/p>\nNow back to the GitLab user dashboard and click the ‘SSH Key’ menu on the left.<\/p>\n
![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-16.png\" "\\"\\"")
<\/a><\/p>\nPaste the ssh public key ‘id_rsa.pub’ and click the ‘Add key’ button.<\/p>\n
Sign up Restrictions<\/h3>\n
Click the ‘Admin area’ button on the middle, then click ‘Settings’.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-17.png\" "\\"\\"")
<\/a><\/p>\nUncheck the ‘signup enabled’ option and click the ‘Save changes’ button.<\/p>\n
Account Limit<\/h3>\n
Click on the ‘Account and limit’ section and set the default project limit to 20.<\/p>\n
![\"Set](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-18.png\" "\\"\\"")
<\/a><\/p>\nAnd click the ‘Save changes’ button.<\/p>\n
Step 8 – Testing Gitlab<\/h2>\n
Finally, we will do some tests to ensure that our GitLab system is working properly.<\/p>\n
Create New Project<\/h3>\n
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.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-19.png\" "\\"\\"")
<\/a><\/p>\nThe new project has been created.<\/p>\n
Test First Commit and Push<\/h3>\n
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.<\/p>\n
git config –global user.name “hakase”
git config –global user.email “[email\u00a0protected]<\/a>“<\/p>\nClone the Repository and add a README.md file.<\/p>\n
git clone https:\/\/git.hakase-labs.pw\/hakase\/project01.git
cd project01\/
vim README.md<\/p>\n
You will be asked for the ‘hakase’ user password. Please type the same password that you used when we accessed GitLab the first time.<\/p>\n
Commit a new file to the ‘project01’ repository.<\/p>\n
git add .
git commit -m ‘Add README.md file by hakase-labs’<\/p>\n
Next, push the change to the repository on the GitLab server.<\/p>\n
git push origin master<\/p>\n
Type in your password and press Enter to continue. You will see the result as below.<\/p>\n
![\"Git](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-20.png\" "\\"\\"")
<\/a><\/p>\nNow open the ‘project01’ project from your web browser, and you will see that the new README.md file has been added to the repository.<\/p>\n
![\"Test](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-21.png\" "\\"\\"")
<\/a><\/p>\nGitLab installation guide on Ubuntu 18.04 has been completed successfully.<\/p>\n
Reference<\/h2>\n\nAbout Muhammad Arul<\/strong><\/p>\nMuhammad Arul is a freelance system administrator and technical writer. He is working with Linux Environments for more than 5 years, an Open Source enthusiast and highly motivated on Linux installation and troubleshooting. Mostly working with RedHat\/CentOS Linux and Ubuntu\/Debian, Nginx and Apache web server, Proxmox, Zimbra Administration, and Website Optimization. Currently learning about OpenStack and Container Technology.<\/p>\n<\/div>\n
\nShare this page:<\/b><\/p>\n
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-22.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-23.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-24.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/09\/how-to-install-and-configure-gitlab-on-ubuntu-18-04-lts-25.png\" "\\"\\"")
<\/a>\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36],"tags":[],"class_list":["post-6724","post","type-post","status-publish","format-standard","hentry","category-36"],"_links":{"self":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6724","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/comments?post=6724"}],"version-history":[{"count":0,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6724\/revisions"}],"wp:attachment":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/media?parent=6724"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/categories?post=6724"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/tags?post=6724"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
What we will do<\/h2>\n\n- Update Repository and Upgrade Packages<\/li>\n
- Install Dependencies<\/li>\n
- Install GitLab Community Edition<\/li>\n
- Generate SSL Letsencrypt and DHPARAM Certificate<\/li>\n
- Configure HTTPS for GitLab<\/li>\n
- Configure Ubuntu UFW Firewall<\/li>\n
- GitLab Post-Installation<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Update Repository and Upgrade Packages<\/h2>\n
Before installing any packages on the system, update all available repositories and then upgrade all packages on the system.<\/p>\n
Run apt commands below.<\/p>\n
sudo apt update
sudo apt upgrade -y<\/p>\n
Wait for the installation packages that will be upgraded.<\/p>\n
<\/a><\/p>\nStep 2 – Install Gitlab Dependencies<\/h2>\n
GitLab needs some packages dependencies for the installation, including curl, postfix, and ca-certificates.<\/p>\n
Install GitLab packages dependencies using the apt command below.<\/p>\n
sudo apt install curl openssh-server ca-certificates postfix -y<\/p>\n
During postfix installation, you will be prompted about the configuration, select ‘Internet Site’.<\/p>\n
<\/a><\/p>\nAnd then enter the server domain name that shall be used for sending an email.<\/p>\n
<\/a><\/p>\nAnd we’re ready to install GitLab on the server.<\/p>\n
Step 3 – Install GitLab<\/h2>\n
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.<\/p>\n
Add GitLab repository with the curl command.<\/p>\n
curl -sS https:\/\/packages.gitlab.com\/install\/repositories\/gitlab\/gitlab-ce\/script.deb.sh | sudo bash<\/p>\n
<\/a><\/p>\nAnd then install GitLab CE Community Edition with the apt command.<\/p>\n
sudo apt install gitlab-ce -y<\/p>\n
The command will download and install the GitLab CE package, and when the installation is complete, you will see the results as below.<\/p>\n
<\/a><\/p>\nNext, 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.<\/p>\n
To change the GitLab URL access, edit the ‘\/etc\/gitlab\/gitlab.rb’ file.<\/p>\n
sudo vim \/etc\/gitlab\/gitlab.rb<\/p>\n
Now change the ‘external_url’ value with your own domain name.<\/p>\n
external_url 'http:\/\/git.hakase-labs.pw'<\/pre>\nSave and exit.<\/p>\n
Step 4 – Generate Let’s encrypt SSL Certificate and DHPARAM Certificate<\/h2>\n
In this step, we will generate a new Letsencrypt certificate and DHPARAM certificate for the GitLab domain name ‘git.hakase-labs.pw’.<\/p>\n
Install the lets encrypt tool using the apt command below.<\/p>\n
sudo apt install letsencrypt -y<\/p>\n
And after the installation is complete, run the letsencrypt command below.<\/p>\n
sudo letsencrypt certonly –standalone –agree-tos –no-eff-email –agree-tos –email [email\u00a0protected]<\/a> -d git.hakase-labs.pw<\/p>\nAnd when it’s complete, you will get the result as shown below.<\/p>\n
<\/a><\/p>\nSSL Letsencrypt certificates have been generated, located in the ‘\/etc\/letsencyrpt\/’ directory.<\/p>\n
Next, we will generate the DHPARAM certificate using the OpenSSL command.<\/p>\n
Create a new directory ‘\/etc\/gitlab\/ssl’ and run the OpenSSL command below.<\/p>\n
sudo mkdir -p \/etc\/gitlab\/ssl\/
sudo openssl dhparam -out \/etc\/gitlab\/ssl\/dhparams.pem 2048<\/p>\n
Now change the permission of the SSL directory.<\/p>\n
chmod 600 \/etc\/gitlab\/ssl\/*<\/p>\n
<\/a><\/p>\nAnd all certificates needed for GitLab HTTPS configuration have been generated.<\/p>\n
Step 5 – Configure HTTPS for GitLab<\/h2>\n
In order to enable the HTTPS for GitLab installation, we need to edit the ‘gitlab.rb’ file.<\/p>\n
Edit the ‘\/etc\/gitlab\/gitlab.rb’ file using the\u00a0vim command<\/a> below.<\/p>\nsudo vim \/etc\/gitlab\/gitlab.rb<\/p>\n
Change the ‘external_url’ of Gitlab to the ‘https:\/\/git.hakase-labs.pw’.<\/p>\n
external_url 'https:\/\/git.hakase-labs.pw'<\/pre>\nNow paste configuration below to the ‘#GitLab Nginx’ section.<\/p>\n
nginx['redirect_http_to_https'] = true
\nnginx['ssl_certificate'] = \"\/etc\/letsencrypt\/live\/git.hakase-labs.pw\/fullchain.pem\"
\nnginx['ssl_certificate_key'] = \"\/etc\/letsencrypt\/live\/git.hakase-labs.pw\/privkey.pem\"
\nnginx['ssl_dhparam'] = \"\/etc\/gitlab\/ssl\/dhparams.pem\"<\/pre>\nSave and exit.<\/p>\n
<\/a><\/p>\nNow run the ‘gitlab-ctl’ command below.<\/p>\n
sudo gitlab-ctl reconfigure<\/p>\n
This command will install and configure GitLab based on the ‘\/etc\/gitlab\/gitlab.rb’ configuration file.<\/p>\n
And when it’s complete, you will see the result as below.<\/p>\n
<\/a><\/p>\nThe GitLab installation is complete, and HTTPS for GitLab has been enabled.<\/p>\n
Step 6 – Configure Ubuntu UFW Firewall<\/h2>\n
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.<\/p>\n
Add ssh, http, and https services to the configuration.<\/p>\n
sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https<\/p>\n
And enable the Ubuntu UFW firewall with the command below.<\/p>\n
sudo ufw enable<\/p>\n
Type ‘y’ for yes to enabled it.<\/p>\n
Now check all services and ports list on the list.<\/p>\n
sudo ufw status<\/p>\n
And you will get ssh, http, and https services on the list.<\/p>\n
<\/a><\/p>\nStep 7 – GitLab Post-Installation<\/h2>\n
Open the web browser and type in the gitlab URL ‘git.hakase-labs.pw’, and you will be redirected to the HTTPS connection.<\/p>\n
Create a New GitLab Root Password<\/h3>\n
Type your new password for root GitLab user, and click the ‘Change your password’ button.<\/p>\n
<\/a><\/p>\nNow Login as a ‘root’ user with your own password and click the ‘Login’ button.<\/p>\n
<\/a><\/p>\nNow you will get the GitLab Dashboard.<\/p>\n
<\/a><\/p>\nChange Profile<\/h3>\n
Click the profile button and choose ‘Settings’.<\/p>\n
<\/a><\/p>\nOn the ‘Main Settings’ section, type the profile name ‘hakase’ and then click the ‘update profile settings’ option.<\/p>\n
Change Username<\/h3>\n
Click the ‘Account’ tab and type the username ‘hakase’.<\/p>\n
<\/a><\/p>\nNow press the ‘Update username’ button.<\/p>\n
Add SSH Key<\/h3>\n
Generate a new key using the ssh-keygen command as below.<\/p>\n
ssh-keygen
cat ~\/.ssh\/id_rsa.pub<\/p>\n
Copy the ‘id_rsa.pub’ key.<\/p>\n
<\/a><\/p>\nNow back to the GitLab user dashboard and click the ‘SSH Key’ menu on the left.<\/p>\n
<\/a><\/p>\nPaste the ssh public key ‘id_rsa.pub’ and click the ‘Add key’ button.<\/p>\n
Sign up Restrictions<\/h3>\n
Click the ‘Admin area’ button on the middle, then click ‘Settings’.<\/p>\n
<\/a><\/p>\nUncheck the ‘signup enabled’ option and click the ‘Save changes’ button.<\/p>\n
Account Limit<\/h3>\n
Click on the ‘Account and limit’ section and set the default project limit to 20.<\/p>\n
<\/a><\/p>\nAnd click the ‘Save changes’ button.<\/p>\n
Step 8 – Testing Gitlab<\/h2>\n
Finally, we will do some tests to ensure that our GitLab system is working properly.<\/p>\n
Create New Project<\/h3>\n
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.<\/p>\n
<\/a><\/p>\nThe new project has been created.<\/p>\n
Test First Commit and Push<\/h3>\n
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.<\/p>\n
git config –global user.name “hakase”
git config –global user.email “[email\u00a0protected]<\/a>“<\/p>\nClone the Repository and add a README.md file.<\/p>\n
git clone https:\/\/git.hakase-labs.pw\/hakase\/project01.git
cd project01\/
vim README.md<\/p>\n
You will be asked for the ‘hakase’ user password. Please type the same password that you used when we accessed GitLab the first time.<\/p>\n
Commit a new file to the ‘project01’ repository.<\/p>\n
git add .
git commit -m ‘Add README.md file by hakase-labs’<\/p>\n
Next, push the change to the repository on the GitLab server.<\/p>\n
git push origin master<\/p>\n
Type in your password and press Enter to continue. You will see the result as below.<\/p>\n
<\/a><\/p>\nNow open the ‘project01’ project from your web browser, and you will see that the new README.md file has been added to the repository.<\/p>\n
<\/a><\/p>\nGitLab installation guide on Ubuntu 18.04 has been completed successfully.<\/p>\n
Reference<\/h2>\n\nAbout Muhammad Arul<\/strong><\/p>\nMuhammad Arul is a freelance system administrator and technical writer. He is working with Linux Environments for more than 5 years, an Open Source enthusiast and highly motivated on Linux installation and troubleshooting. Mostly working with RedHat\/CentOS Linux and Ubuntu\/Debian, Nginx and Apache web server, Proxmox, Zimbra Administration, and Website Optimization. Currently learning about OpenStack and Container Technology.<\/p>\n<\/div>\n
\nShare this page:<\/b><\/p>\n
\n<\/a>
\n<\/a>
\n<\/a>
\n<\/a>\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36],"tags":[],"class_list":["post-6724","post","type-post","status-publish","format-standard","hentry","category-36"],"_links":{"self":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6724","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/comments?post=6724"}],"version-history":[{"count":0,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6724\/revisions"}],"wp:attachment":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/media?parent=6724"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/categories?post=6724"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/tags?post=6724"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Step 1 – Update Repository and Upgrade Packages<\/h2>\n
Before installing any packages on the system, update all available repositories and then upgrade all packages on the system.<\/p>\n
Run apt commands below.<\/p>\n
sudo apt update
sudo apt upgrade -y<\/p>\n
Wait for the installation packages that will be upgraded.<\/p>\n
GitLab needs some packages dependencies for the installation, including curl, postfix, and ca-certificates.<\/p>\n Install GitLab packages dependencies using the apt command below.<\/p>\n sudo apt install curl openssh-server ca-certificates postfix -y<\/p>\n During postfix installation, you will be prompted about the configuration, select ‘Internet Site’.<\/p>\n And then enter the server domain name that shall be used for sending an email.<\/p>\n And we’re ready to install GitLab on the server.<\/p>\n 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.<\/p>\n Add GitLab repository with the curl command.<\/p>\n curl -sS https:\/\/packages.gitlab.com\/install\/repositories\/gitlab\/gitlab-ce\/script.deb.sh | sudo bash<\/p>\n And then install GitLab CE Community Edition with the apt command.<\/p>\n sudo apt install gitlab-ce -y<\/p>\n The command will download and install the GitLab CE package, and when the installation is complete, you will see the results as below.<\/p>\n 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.<\/p>\n To change the GitLab URL access, edit the ‘\/etc\/gitlab\/gitlab.rb’ file.<\/p>\n sudo vim \/etc\/gitlab\/gitlab.rb<\/p>\n Now change the ‘external_url’ value with your own domain name.<\/p>\n Save and exit.<\/p>\n In this step, we will generate a new Letsencrypt certificate and DHPARAM certificate for the GitLab domain name ‘git.hakase-labs.pw’.<\/p>\n Install the lets encrypt tool using the apt command below.<\/p>\n sudo apt install letsencrypt -y<\/p>\n And after the installation is complete, run the letsencrypt command below.<\/p>\n sudo letsencrypt certonly –standalone –agree-tos –no-eff-email –agree-tos –email [email\u00a0protected]<\/a> -d git.hakase-labs.pw<\/p>\n And when it’s complete, you will get the result as shown below.<\/p>\n SSL Letsencrypt certificates have been generated, located in the ‘\/etc\/letsencyrpt\/’ directory.<\/p>\n Next, we will generate the DHPARAM certificate using the OpenSSL command.<\/p>\n Create a new directory ‘\/etc\/gitlab\/ssl’ and run the OpenSSL command below.<\/p>\n sudo mkdir -p \/etc\/gitlab\/ssl\/ Now change the permission of the SSL directory.<\/p>\n chmod 600 \/etc\/gitlab\/ssl\/*<\/p>\n And all certificates needed for GitLab HTTPS configuration have been generated.<\/p>\n In order to enable the HTTPS for GitLab installation, we need to edit the ‘gitlab.rb’ file.<\/p>\n Edit the ‘\/etc\/gitlab\/gitlab.rb’ file using the\u00a0vim command<\/a> below.<\/p>\n sudo vim \/etc\/gitlab\/gitlab.rb<\/p>\n Change the ‘external_url’ of Gitlab to the ‘https:\/\/git.hakase-labs.pw’.<\/p>\n Now paste configuration below to the ‘#GitLab Nginx’ section.<\/p>\n Save and exit.<\/p>\n Now run the ‘gitlab-ctl’ command below.<\/p>\n sudo gitlab-ctl reconfigure<\/p>\n This command will install and configure GitLab based on the ‘\/etc\/gitlab\/gitlab.rb’ configuration file.<\/p>\n And when it’s complete, you will see the result as below.<\/p>\n The GitLab installation is complete, and HTTPS for GitLab has been enabled.<\/p>\n 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.<\/p>\n Add ssh, http, and https services to the configuration.<\/p>\n sudo ufw allow ssh And enable the Ubuntu UFW firewall with the command below.<\/p>\n sudo ufw enable<\/p>\n Type ‘y’ for yes to enabled it.<\/p>\n Now check all services and ports list on the list.<\/p>\n sudo ufw status<\/p>\n And you will get ssh, http, and https services on the list.<\/p>\n Open the web browser and type in the gitlab URL ‘git.hakase-labs.pw’, and you will be redirected to the HTTPS connection.<\/p>\n Type your new password for root GitLab user, and click the ‘Change your password’ button.<\/p>\n Now Login as a ‘root’ user with your own password and click the ‘Login’ button.<\/p>\n Now you will get the GitLab Dashboard.<\/p>\n Click the profile button and choose ‘Settings’.<\/p>\n On the ‘Main Settings’ section, type the profile name ‘hakase’ and then click the ‘update profile settings’ option.<\/p>\n Click the ‘Account’ tab and type the username ‘hakase’.<\/p>\n Now press the ‘Update username’ button.<\/p>\n Generate a new key using the ssh-keygen command as below.<\/p>\n ssh-keygen Copy the ‘id_rsa.pub’ key.<\/p>\n Now back to the GitLab user dashboard and click the ‘SSH Key’ menu on the left.<\/p>\n Paste the ssh public key ‘id_rsa.pub’ and click the ‘Add key’ button.<\/p>\n Click the ‘Admin area’ button on the middle, then click ‘Settings’.<\/p>\n Uncheck the ‘signup enabled’ option and click the ‘Save changes’ button.<\/p>\n Click on the ‘Account and limit’ section and set the default project limit to 20.<\/p>\n And click the ‘Save changes’ button.<\/p>\n Finally, we will do some tests to ensure that our GitLab system is working properly.<\/p>\n 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.<\/p>\n The new project has been created.<\/p>\n 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.<\/p>\n git config –global user.name “hakase” Clone the Repository and add a README.md file.<\/p>\n 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.<\/p>\n Commit a new file to the ‘project01’ repository.<\/p>\n git add . Next, push the change to the repository on the GitLab server.<\/p>\n git push origin master<\/p>\n Type in your password and press Enter to continue. You will see the result as below.<\/p>\n 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.<\/p>\n GitLab installation guide on Ubuntu 18.04 has been completed successfully.<\/p>\n About Muhammad Arul<\/strong><\/p>\n Muhammad Arul is a freelance system administrator and technical writer. He is working with Linux Environments for more than 5 years, an Open Source enthusiast and highly motivated on Linux installation and troubleshooting. Mostly working with RedHat\/CentOS Linux and Ubuntu\/Debian, Nginx and Apache web server, Proxmox, Zimbra Administration, and Website Optimization. Currently learning about OpenStack and Container Technology.<\/p>\n<\/div>\n Share this page:<\/b><\/p>\n \n 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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36],"tags":[],"class_list":["post-6724","post","type-post","status-publish","format-standard","hentry","category-36"],"_links":{"self":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6724","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/comments?post=6724"}],"version-history":[{"count":0,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/6724\/revisions"}],"wp:attachment":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/media?parent=6724"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/categories?post=6724"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/tags?post=6724"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Install](\"https:\/\/www.howtoforge.com\/images\/how_to_install_and_configure_gitlab_on_ubuntu_1804\/big\/1.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install Gitlab Dependencies<\/h2>\n
<\/a><\/p>\n<\/a><\/p>\nStep 3 – Install GitLab<\/h2>\n
<\/a><\/p>\n<\/a><\/p>\nexternal_url 'http:\/\/git.hakase-labs.pw'<\/pre>\n
Step 4 – Generate Let’s encrypt SSL Certificate and DHPARAM Certificate<\/h2>\n
<\/a><\/p>\n
sudo openssl dhparam -out \/etc\/gitlab\/ssl\/dhparams.pem 2048<\/p>\n<\/a><\/p>\nStep 5 – Configure HTTPS for GitLab<\/h2>\n
external_url 'https:\/\/git.hakase-labs.pw'<\/pre>\n
nginx['redirect_http_to_https'] = true
\nnginx['ssl_certificate'] = \"\/etc\/letsencrypt\/live\/git.hakase-labs.pw\/fullchain.pem\"
\nnginx['ssl_certificate_key'] = \"\/etc\/letsencrypt\/live\/git.hakase-labs.pw\/privkey.pem\"
\nnginx['ssl_dhparam'] = \"\/etc\/gitlab\/ssl\/dhparams.pem\"<\/pre>\n
<\/a><\/p>\n<\/a><\/p>\nStep 6 – Configure Ubuntu UFW Firewall<\/h2>\n
sudo ufw allow http
sudo ufw allow https<\/p>\n<\/a><\/p>\nStep 7 – GitLab Post-Installation<\/h2>\n
Create a New GitLab Root Password<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\nChange Profile<\/h3>\n
<\/a><\/p>\nChange Username<\/h3>\n
<\/a><\/p>\nAdd SSH Key<\/h3>\n
cat ~\/.ssh\/id_rsa.pub<\/p>\n<\/a><\/p>\n<\/a><\/p>\nSign up Restrictions<\/h3>\n
<\/a><\/p>\nAccount Limit<\/h3>\n
<\/a><\/p>\nStep 8 – Testing Gitlab<\/h2>\n
Create New Project<\/h3>\n
<\/a><\/p>\nTest First Commit and Push<\/h3>\n
git config –global user.email “[email\u00a0protected]<\/a>“<\/p>\n
cd project01\/
vim README.md<\/p>\n
git commit -m ‘Add README.md file by hakase-labs’<\/p>\n<\/a><\/p>\n<\/a><\/p>\nReference<\/h2>\n
<\/a>
\n<\/a>
\n<\/a>
\n<\/a>\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"