Commit 6e87c913 authored by Patrick Steinhardt's avatar Patrick Steinhardt Committed by Evan Read

Add sections to package and dependency installation

The documentation on doing source installations has quite a long section
on installing packages and dependencies for GitLab, which makes it easy
to loose track where one currently is.

Add some subsections to make it easier to read.
parent 6f874c82
...@@ -90,6 +90,8 @@ The GitLab installation consists of setting up the following components: ...@@ -90,6 +90,8 @@ The GitLab installation consists of setting up the following components:
## 1. Packages and dependencies ## 1. Packages and dependencies
### sudo
`sudo` is not installed on Debian by default. Make sure your system is `sudo` is not installed on Debian by default. Make sure your system is
up-to-date and install it. up-to-date and install it.
...@@ -110,6 +112,8 @@ sudo apt-get install -y vim ...@@ -110,6 +112,8 @@ sudo apt-get install -y vim
sudo update-alternatives --set editor /usr/bin/vim.basic sudo update-alternatives --set editor /usr/bin/vim.basic
``` ```
### Build dependencies
Install the required packages (needed to compile Ruby and native extensions to Ruby gems): Install the required packages (needed to compile Ruby and native extensions to Ruby gems):
```shell ```shell
...@@ -129,6 +133,8 @@ If you want to use Kerberos for user authentication, install `libkrb5-dev` ...@@ -129,6 +133,8 @@ If you want to use Kerberos for user authentication, install `libkrb5-dev`
sudo apt-get install libkrb5-dev sudo apt-get install libkrb5-dev
``` ```
### Git
Make sure you have the right version of Git installed: Make sure you have the right version of Git installed:
```shell ```shell
...@@ -168,18 +174,9 @@ On Debian, use the following compilation instructions: ...@@ -168,18 +174,9 @@ On Debian, use the following compilation instructions:
```shell ```shell
# Install dependencies # Install dependencies
sudo apt-get install -y libcurl4-openssl-dev libexpat1-dev gettext libz-dev libssl-dev build-essential sudo apt-get install -y libcurl4-openssl-dev libexpat1-dev gettext libz-dev libssl-dev libpcre2-dev build-essential
# Download and compile pcre2 from source
curl --silent --show-error --location https://ftp.pcre.org/pub/pcre/pcre2-10.33.tar.gz --output pcre2.tar.gz
tar -xzf pcre2.tar.gz
cd pcre2-10.33
chmod +x configure
./configure --prefix=/usr --enable-jit
make
sudo make install
# Download and compile from source # Download and compile Git from source
cd /tmp cd /tmp
curl --remote-name --location --progress https://www.kernel.org/pub/software/scm/git/git-2.29.0.tar.gz curl --remote-name --location --progress https://www.kernel.org/pub/software/scm/git/git-2.29.0.tar.gz
echo 'fa08dc8424ef80c0f9bf307877f9e2e49f1a6049e873530d6747c2be770742ff git-2.29.0.tar.gz' | shasum -a256 -c - && tar -xzf git-2.29.0.tar.gz echo 'fa08dc8424ef80c0f9bf307877f9e2e49f1a6049e873530d6747c2be770742ff git-2.29.0.tar.gz' | shasum -a256 -c - && tar -xzf git-2.29.0.tar.gz
...@@ -193,6 +190,8 @@ sudo make prefix=/usr/local install ...@@ -193,6 +190,8 @@ sudo make prefix=/usr/local install
# When editing config/gitlab.yml later, change the git -> bin_path to /usr/local/bin/git # When editing config/gitlab.yml later, change the git -> bin_path to /usr/local/bin/git
``` ```
### GraphicsMagick
For the [Custom Favicon](../user/admin_area/appearance.md#favicon) to work, GraphicsMagick For the [Custom Favicon](../user/admin_area/appearance.md#favicon) to work, GraphicsMagick
needs to be installed. needs to be installed.
...@@ -200,6 +199,8 @@ needs to be installed. ...@@ -200,6 +199,8 @@ needs to be installed.
sudo apt-get install -y graphicsmagick sudo apt-get install -y graphicsmagick
``` ```
### Mail server
In order to receive mail notifications, make sure to install a mail server. In order to receive mail notifications, make sure to install a mail server.
By default, Debian is shipped with `exim4` but this By default, Debian is shipped with `exim4` but this
[has problems](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/12754) while [has problems](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/12754) while
...@@ -212,6 +213,8 @@ sudo apt-get install -y postfix ...@@ -212,6 +213,8 @@ sudo apt-get install -y postfix
Then select 'Internet Site' and press enter to confirm the hostname. Then select 'Internet Site' and press enter to confirm the hostname.
### Exiftool
[GitLab Workhorse](https://gitlab.com/gitlab-org/gitlab-workhorse#dependencies) [GitLab Workhorse](https://gitlab.com/gitlab-org/gitlab-workhorse#dependencies)
requires `exiftool` to remove EXIF data from uploaded images. requires `exiftool` to remove EXIF data from uploaded images.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment