How To Install gitlab-workhorse on Debian 9

In this tutorial we learn how to install gitlab-workhorse on Debian 9. gitlab-workhorse is unloads Git HTTP traffic from the GitLab Rails app (Unicorn)

Introduction

In this tutorial we learn how to install gitlab-workhorse on Debian 9.

What is gitlab-workhorse

gitlab-workhorse is:

gitlab-workhorse was designed to unload Git HTTP traffic from the GitLab Rails app (Unicorn) to a separate daemon. It also serves ‘git archive’ downloads for GitLab. All authentication and authorization logic is still handled by the GitLab Rails app.

Architecture: Git client -> NGINX -> gitlab-workhorse (makes auth request to GitLab Rails app) -> git-upload-pack

There are three methods to install gitlab-workhorse on Debian 9. We can use apt-get, apt and aptitude. In the following sections we will describe each method. You can choose one of them.

Install gitlab-workhorse Using apt-get

Update apt database with apt-get using the following command.

sudo apt-get update

After updating apt database, We can install gitlab-workhorse using apt-get by running the following command:

sudo apt-get -y install gitlab-workhorse

Install gitlab-workhorse Using apt

Update apt database with apt using the following command.

sudo apt update

After updating apt database, We can install gitlab-workhorse using apt by running the following command:

sudo apt -y install gitlab-workhorse

Install gitlab-workhorse Using aptitude

If you want to follow this method, you might need to install aptitude first since aptitude is usually not installed by default on Debian. Update apt database with aptitude using the following command.

sudo aptitude update

After updating apt database, We can install gitlab-workhorse using aptitude by running the following command:

sudo aptitude -y install gitlab-workhorse

How To Uninstall gitlab-workhorse on Debian 9

To uninstall only the gitlab-workhorse package we can use the following command:

sudo apt-get remove gitlab-workhorse

Uninstall gitlab-workhorse And Its Dependencies

To uninstall gitlab-workhorse and its dependencies that are no longer needed by Debian 9, we can use the command below:

sudo apt-get -y autoremove gitlab-workhorse

Remove gitlab-workhorse Configurations and Data

To remove gitlab-workhorse configuration and data from Debian 9 we can use the following command:

sudo apt-get -y purge gitlab-workhorse

Remove gitlab-workhorse configuration, data, and all of its dependencies

We can use the following command to remove gitlab-workhorse configurations, data and all of its dependencies, we can use the following command:

sudo apt-get -y autoremove --purge gitlab-workhorse

Dependencies

gitlab-workhorse have the following dependencies:

References

Summary

In this tutorial we learn how to install gitlab-workhorse package on Debian 9 using different package management tools: apt, apt-get and aptitude.