How to install GitLab in an offline environment

GitLab is a popular web-based Git repository management tool that provides a series of version control and collaboration features that can help teams effectively manage code. However, installing GitLab on a local server is usually the best option when you have a good internet connection. However, if your server cannot connect to the Internet, installing GitLab offline becomes a must. This article will introduce how to install GitLab in an offline environment.

1. Download GitLab source code

First, you need to download the source code from the GitLab official website. You can choose a specific version or download the latest stable version. After downloading, copy the source code package to the local storage of the target machine or a network location with access permissions.

2. Installing dependencies

Before starting to install GitLab, you need to confirm whether the corresponding dependencies are installed on the target machine. GitLab requires the following software packages and libraries:

• redis
• ruby
• postfix or sendmail (optional)
• build-essential
• libmysqlclient-dev

Before using apt-get to install, make sure that the target machine can connect to the ubuntu/Debian official software warehouse, otherwise you can save it to the hard disk externally, and then use Command line installation.

For example: To install the necessary dependencies on an Ubuntu system, you can use the following command:

sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

3. Set environment variables

To ensure that GitLab can To work properly, some environment variables need to be configured. These environment variables include:

• GITLAB_HOME - the root directory of GitLab, used to store GitLab's data files.
• GITLAB_LOG_DIR - GitLab's log directory.
• GITLAB_BACKUP_DIR - GitLab's backup directory.
• UNICORN_WORKERS - The number of Unicorn worker processes.
• SIDEKIQ_WORKERS - The number of Sidekiq worker processes.

On Ubuntu systems, you can add these environment variables to the /etc/profile file:

export GITLAB_HOME=/data/gitlab
export GITLAB_LOG_DIR=/var/log/gitlab
export GITLAB_BACKUP_DIR=/var/opt/gitlab/backups
export SIDEKIQ_WORKERS=4
export UNICORN_WORKERS=4

4. Install Ruby

Because GitLab is written in Ruby on Rails, so Ruby needs to be installed. Stable versions of Ruby can be downloaded from the official Ruby website.

curl -L https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm install 2.6.5
rvm use 2.6.5 --default

5. Install GitLab

Now, you can start installing GitLab. First, install GitLab by unzipping the GitLab source code package. You can use the following command:

tar zxvf gitlab-x_x_x.tar.gz
cd gitlab-x_x_x/

Then, you can run the command to configure and install GitLab:

sudo ./configure --disable-absolute_paths_in_gitlab_yaml --disable-ssh --disable-postgresql --disable-geoip_database --disable-dependency-tracking
sudo make install

6. Configure GitLab

After installation, you need to GitLab is configured. In the source code of GitLab, there is a file named "gitlab.yml", which contains all the configuration of GitLab.

In an offline environment, you need to do the following steps:

• Change the access IP address to the internal network IP address.
• Configure the SMTP address so that GitLab can send emails.
• Configure GitLab's hosting name and transmission protocol (http or https).
• Configure the storage location of GitLab data files and log files.

After the configuration is completed, restart GitLab.

7. Install the SSL certificate

Finally, you can set up the SSL certificate for GitLab. Here, you need to develop your own certificate because certificates issued by public Certificate Authority (CA) cannot be used in an offline environment.

Create the self-signed certificate and key using this command:

sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/gitlab/ssl/gitlab.key -out /etc/gitlab/ssl/gitlab.crt

Add the following 3 lines to the GitLab configuration file:

ssl_certificate /etc/gitlab/ssl/gitlab.crt;
ssl_certificate_key /etc/gitlab/ssl/gitlab.key;

Finally, restart GitLab and test the connection.

Conclusion

GitLab is a very useful tool that provides a series of functions for code management, version control and collaboration. If your environment does not have a network connection, then installing GitLab offline becomes a must. In this article, we explain how to install and configure GitLab in an offline environment, which will keep you in control of your code management.

The above is the detailed content of How to install GitLab in an offline environment. For more information, please follow other related articles on the PHP Chinese website!