How to Install and Configure GitLab on CentOS 8/7

Gitlab is an open-source, powerful, robust, scalable, secure, as well as efficient software development and collaboration platform for all stages of the DevOps lifecycle.

It allows you to plan your development process; code, and verify; package software, and release it with an in-built continuous delivery feature; automate configurations management, and monitor software performance.

Read Also: 10 Best GitHub Alternatives to Host Open Source Projects

It has features such as an issue tracker, moving of issues between projects, time tracking, very powerful branching tools, file locking, merge requests, custom notifications, project roadmaps, burndown charts for project and group milestones, and so much more.

Gitlab is one of the best alternatives to Github for hosting your open source projects, that you will find out there.

In this article, we will explain how to install and configure Gitlab (Git-repository manager) on CentOS 8/7 or RHEL 8/7 Linux distributions.

Step 1: Install and Configure Required Dependencies

1. First, start by installing the following necessary dependencies using the yum package manager as shown.

# yum install curl policycoreutils-python openssh-server 

2. Next, install Postfix service to send notification emails, and enable it to start at system boot, then check if it is up and running using following commands.

# yum install postfix
# systemctl start postfix
# systemctl enable postfix
# systemctl status postfix

During Postfix installation a configuration window may appear. Select ‘Internet Site‘ and use your server’s external DNS for ‘mail name‘ and press enter. If extra screens appear, continue to press enter to accept the defaults.

Step 2: Add GitLab Repository and Install Package

3. Now add the GitLab package YUM repository to your system by running the following script.

$ curl | sudo bash

4. Next, install the GitLab Community Edition package using the following command and make sure to change ‘‘ to the URL at which you want to access your GitLab instance from a web browser.

# EXTERNAL_URL="" yum install -y gitlab-ce

Note: If you want to change your main URL, you can configure it in the GitLab main configuration file /etc/gitlab/gitlab.rb in the external_url section. Once changed, don’t forget to reconfigure gitlab to apply the recent changes in the configuration file using the following command.

# gitlab-ctl reconfigure

5. If you have a system firewall enabled, you need to open port 80 (HTTP) and 443 (HTTPS) to allow connections in the system firewall.

# firewall-cmd --permanent --add-service=80/tcp
# firewall-cmd --permanent --add-service=443/tcp
# systemctl reload firewalld

Step 3: Perform Initial Gitlab Setup

6. Now, open a web browser and access your gitlab instance using the following URL you set during installation.

7. On your first visit, you’ll be redirected to a password reset screen, create a new password for your new admin account and click “Change your password”. Once you set, it will be redirected back to the login screen and login with username root and the password you set.

GitLab Admin Login
GitLab Admin Login

8. After a successful login, it should take you into the admin user account as shown in the screenshot. From, here, you can create an object, create a group, add people or configure your gitlab instance as you wish. You can also edit your user profile, configure your email, and add SSH keys to your gitlab instance, and more.

Gitlab Admin Control Panel
Gitlab Admin Control Panel

For more information, go to Gitlab About Page:

That’s all for now! In this article, we have explained how to install and configure a Gitlab (Git-repository manager) on CentOS 8/7 or RHEL 8/7 Linux distributions. If you have any questions or thoughts to add to this guide, use the comment form below to reach us.

If you read this far, tweet to the author to show them you care. Tweet a thanks
Aaron Kili
Aaron Kili is a Linux and F.O.S.S enthusiast, an upcoming Linux SysAdmin, web developer, and currently a content creator for TecMint who loves working with computers and strongly believes in sharing knowledge.

Each tutorial at TecMint is created by a team of experienced Linux system administrators so that it meets our high-quality standards.

Join the TecMint Weekly Newsletter (More Than 156,129 Linux Enthusiasts Have Subscribed)
Was this article helpful? Please add a comment or buy me a coffee to show your appreciation.

22 thoughts on “How to Install and Configure GitLab on CentOS 8/7”

  1. Hi, I have a development server running Redhat 7 I have Apache, PHP and MariaDB installed and working I am currently using port 443 for testing. Because this is a development server it is not accessible to the public it is only used to write new code on and test.

    But I need GIT so I can utilize version control. So I wanted to install GITLABS on this server instead of standing up a new server for this. Because I am not accessing this from External location . can you tell me how can I access locally instead of this command:

    "EXTERNAL_URL="" yum install -y gitlab-ce"   

    any help would be Appreciated


    • @David

      You can add your local domain in the /etc/hosts file like this (replace and gitlab.mylocaldomain.lan with your dev server’s IP address and local domain respectively):  gitlab.mylocaldomain.lan  

      Save the file and close it. Then run the installation command like this:

      # EXTERNAL_URL="http://gitlab.mylocaldomain.lan "yum install -y gitlab-ce"

      After installation, you can use the following URL in the browser (check the image in the screenshot in the article):

  2. In my case, I’m having some issues with SELinux. I was running gitlab-ctl reconfigure and I’m getting below error. Can you please help.

    There was an error running gitlab-ctl reconfigure:

    execute[semodule -i /opt/gitlab/embedded/selinux/rhel/7/gitlab-7.2.0-ssh-keygen.pp] (gitlab::selinux line 20) had an error: Mixlib::ShellOut::ShellCommandFailed: Expected process to exit with [0], but received '1'
    ---- Begin output of semodule -i /opt/gitlab/embedded/selinux/rhel/7/gitlab-7.2.0-ssh-keygen.pp ----
    STDERR: Failed to resolve typeattributeset statement at /etc/selinux/targeted/tmp/modules/400/gitlab-7.2.0-ssh-keygen/cil:1
    semodule: Failed!
    ---- End output of semodule -i /opt/gitlab/embedded/selinux/rhel/7/gitlab-7.2.0-ssh-keygen.pp ----
    Ran semodule -i /opt/gitlab/embedded/selinux/rhel/7/gitlab-7.2.0-ssh-keygen.pp returned 1

  3. # firewall-cmd --permanent --add-service=http
    # firewall-cmd --permanent --add-service=https
    # firewall-cmd --permanent --add-port=80/tcp
    # firewall-cmd --permanent --add-port=443/tcp

Got something to say? Join the discussion.

Have a question or suggestion? Please leave a comment to start the discussion. Please keep in mind that all comments are moderated and your email address will NOT be published.