GitLab Installation Guide for Debian 12: Complete Procedure

GitLab is a powerful web-based DevOps lifecycle tool that provides a Git repository manager, wiki, issue-tracking, and continuous integration and deployment pipeline features. It is widely used by developers and organizations to streamline collaboration, version control, and project management. In this comprehensive guide, we will walk you through the step-by-step process of installing GitLab on Debian 12, enabling you to harness its full potential for your software development projects.

1. Introduction to GitLab

Before we delve into the installation process, let’s understand what GitLab is and why it is a valuable tool for software development. GitLab is a web-based DevOps lifecycle tool that offers a comprehensive set of features for version control, project management, and collaboration. It provides a centralized Git repository manager, allowing teams to easily track changes, merge code, and resolve conflicts.

GitLab also includes a wiki feature that enables teams to create and maintain documentation directly within the platform. This promotes knowledge sharing and ensures that important project information is easily accessible to all team members. Additionally, GitLab offers robust issue-tracking capabilities, allowing teams to manage and prioritize tasks efficiently.

One of the key advantages of GitLab is its built-in continuous integration and deployment (CI/CD) pipeline. This feature automates the process of building, testing, and deploying software, ensuring that changes are thoroughly tested before being deployed to production. With GitLab’s CI/CD pipeline, developers can streamline their workflows and deliver high-quality software at a faster pace.

Now that we have a clear understanding of GitLab and its benefits, let’s proceed with the installation process.

2. Prerequisites

Before we begin the installation, make sure you have the following prerequisites in place:

A Debian 12 server with root access
Basic knowledge of the Linux command line
Stable internet connection

3. Updating the System

The first step in the installation process is to update the system to ensure that we have the latest packages and security patches. Open the terminal and run the following command:

apt update
apt upgrade

This will update the package lists and upgrade any outdated packages on your Debian 12 server.

4. Installing Required Dependencies

Next, we need to install some dependencies that are required for GitLab to function properly. Run the following command to install the necessary packages:

apt-get install curl ca-certificates apt-transport-https gnupg2 -y

This command will install the curl, ca-certificates, apt-transport-https, and gnupg2 packages.

5. Adding the GitLab Repository

To install GitLab on Debian 12, we need to add the GitLab repository to our system. Run the following command to add the repository:

curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | bash

This command will add the GitLab repository to your system.

6. Modifying the Source File

At the time of writing this guide, the GitLab package is not available for Debian 12. Therefore, we need to modify the GitLab source file to use the Debian 10 (Buster) code name instead. Open the source file using the following command:

nano /etc/apt/sources.list.d/gitlab_gitlab-ce.list

In the source file, locate the following lines:

deb https://packages.gitlab.com/gitlab/gitlab-ce/debian/ booksworm main
deb-src https://packages.gitlab.com/gitlab/gitlab-ce/debian/ booksworm main

Replace these lines with the following:

deb https://packages.gitlab.com/gitlab/gitlab-ce/debian/ bullseye main
deb-src https://packages.gitlab.com/gitlab/gitlab-ce/debian/ bullseye main

Save and close the file.

7. Installing GitLab CE

Now that we have added the GitLab repository and modified the source file, we can proceed with the installation of GitLab CE. Run the following command to install GitLab:

apt-get update
apt-get install gitlab-ce -y

This command will update the repository and install GitLab CE on your Debian 12 server. The installation process may take a few minutes to complete.

8. Configuring GitLab

Once the installation is complete, we need to configure GitLab to meet our specific requirements. Open the GitLab configuration file using the following command:

nano /etc/gitlab/gitlab.rb

In the configuration file, you will find various options that can be edited to customize GitLab. For example, you can set the external URL for your GitLab instance by replacing the following line with your domain name:

external_url 'https://Your_Domain_Name'

Additionally, if you want to enable Let’s Encrypt SSL for your GitLab instance, you can modify the following lines:

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['youremail@mail.com']
letsencrypt['auto_renew_hour'] = "1"
letsencrypt['auto_renew_minute'] = "0"
letsencrypt['auto_renew_day_of_month'] = "*/1"

Feel free to customize other options in the configuration file according to your needs. Once you have made the necessary changes, save and close the file.

9. Updating the Repository

After configuring GitLab, we need to update the repository to apply the changes. Run the following command to update the repository:

gitlab-ctl reconfigure

This command will apply the configuration changes and update GitLab accordingly.

10. Retrieving the GitLab Password

During the installation process, GitLab generates an initial root password that you can use to log in to the platform. Run the following command to retrieve the initial root password:

cat /etc/gitlab/initial_root_password

This command will display the initial root password. Make sure to save this password in a secure location.

11. Accessing GitLab

Now that GitLab is successfully installed and configured, you can access it by opening a web browser and entering the following address:

https://Your_Domain_Name

Replace Your_Domain_Name with the actual domain name or IP address of your GitLab instance. You will be redirected to the GitLab login page, where you can log in using the initial root password.

Congratulations! You have successfully installed GitLab on Debian 12. You can now start exploring its powerful features and leveraging its capabilities to streamline your software development workflows.

12. Conclusion

In this comprehensive guide, we have walked you through the step-by-step process of installing GitLab on Debian 12. By following these instructions, you have successfully set up a powerful DevOps lifecycle tool that will greatly enhance your software development processes. GitLab’s extensive features, including Git repository management, wiki, issue-tracking, and CI/CD pipeline, will enable you to collaborate effectively, track changes, and deploy high-quality software with ease.

Remember to regularly update and maintain your GitLab instance to ensure optimal performance and security. Additionally, explore GitLab’s documentation and community resources to discover more advanced features and best practices.

Shape.host is a trusted provider of Cloud VPS hosting services, offering reliable and scalable solutions for businesses of all sizes. With Shape.host, you can enjoy hassle-free cloud hosting and benefit from their expert support and cutting-edge infrastructure. Visit Shape.host to learn more about their services and start your journey towards efficient and secure cloud hosting.