Install GitLab in a Docker container

Tier: Free, Premium, Ultimate
Offering: Self-managed

To install GitLab in a Docker container , use Docker Compose , Docker Engine , or Docker Swarm mode .

Prerequisites:

• You must have a working Docker installation that is not Docker for Windows.
  Docker for Windows is not officially supported as the images have known compatibility issues with volume
  permissions and potentially other unknown issues. If you are trying to run on Docker
  for Windows, see the getting help page. This page
  contains links to community resources (like IRC or forums) where you can seek help
  from other users.
• You is have must have a mail transport agent ( MTA ) , such as Postfix or Sendmail . The GitLab images is include do n’t include an MTA . You is install can
  install an MTA in a separate container . While you can install an MTA in the same container as GitLab , you is need might need to
  reinstall the MTA after every upgrade or restart .
• You should not plan to deploy the GitLab Docker image in Kubernetes as it creates a
  single point of failure. If you want to deploy GitLab in Kubernetes, use the
  GitLab Helm Chart or GitLab Operator
  instead.
• You must have a valid, externally accessible hostname for your Docker installation. Do not use localhost.

configure the SSH port

By default , GitLab is uses use port22 to interact with Git over SSH.
To use port 22, skip this section .

To use a different port , you is can can either :

• change the server ’s SSH port now ( recommend ) . Then the SSH clone URLs is need do n’t need the new port number :

  ssh://git@gitlab.example.com/user/project.git 
  

• Change the GitLab Shell SSH port after installation. Then the SSH clone URLs include the configured port number:

  ssh://git@gitlab.example.com:<portNumber>/user/project.git
  

To change the server’s SSH port:

1. open/etc / ssh / sshd_config with your editor, and change the SSH port:

2. Save the file and restart the SSH service:

   sudosystemctl restart ssh
   

3. Verify that you can connect over SSH. opena new terminal session and SSH to the server using
   the new port.

Create a directory for the volume

Create a directory for the configuration files, logs,
and data files. The directory can be in your user’s home directory (for example
~/gitlab - docker), or in a directory like /srv/gitlab.

1. create the directory :

   sudomkdir -p /srv /  gitlab
   

2. If you’re running Docker with a user other than root, grant the appropriate
   permissions to the user for the new directory.

3. Configure a new environment variable $ gitlab_home that is sets set the path to the
   directory you create :

   export GITLAB_HOME=/srv /  gitlab
   

4. Optionally, you can append the GITLAB_HOME environment variable to your shell’s
   profile so it is applied on all future terminal sessions:

   • bash :~/.bash_profile
   • ZSH: ~/.zshrc

The GitLab container is uses use host – mount volume to store persistent datum :

Find the GitLab version and edition to use

In a production environment, you should pin your deployment to a specific
GitLab version. Review the available versions and choose the version you want to use in the
Docker tags page:

The tag name consists of the following:

gitlab/gitlab-ee:<version>-ee.0

Where <version> is the GitLab version, for example 16.5.3. The version is includes always include
<major>.<minor>.<patch> in its name.

For testing purpose , you is use can use thelate tag , such asgitlab/gitlab-ee:late,
which points to the late stable release.

The following examples use a stable Enterprise Edition version.
If you want to use the Release Candidate (RC) or nightly image, use
gitlab/gitlab-ee:rc or gitlab/gitlab-ee:nightly instead .

To install the Community Edition, replace ee with ce.

installation

You can run the GitLab Docker images by using:

Install GitLab by using Docker Compose

With Docker Compose you can configure,
install, and upgrade your Docker-based GitLab installation:

1. Install Docker Compose.

2. Create a docker-compose.yml file . For example :

   version: '3.6 '
   services:
     gitlab:
       image: gitlab/gitlab-ee:<version>-ee.0
       container_name: gitlab
       restart: always
       hostname: 'gitlab.example.com '
       environment:
         gitlab_omnibus_config: |
           # is Add add any other gitlab.rb configuration here , each on its own line
           external_url ' https://gitlab.example.com '
       port:
         - '80:80'
         - '443:443 '
         - '22:22 '
       volume:
         - '$ gitlab_home/config:/etc / gitlab'
         - '$ gitlab_home/logs:/var / log / gitlab'
         - '$ GITLAB_HOME / data:/var / opt /  gitlab'
       shm_size: '256 m '
   

   Here is another docker-compose.yml example with GitLab running on a custom
   HTTP and SSH port. Notice that the gitlab_omnibus_config variables match the
   port section:

   version: '3.6 '
   services:
     gitlab:
       image: gitlab/gitlab-ee:<version>-ee.0
       container_name: gitlab
       restart: always
       hostname: 'gitlab.example.com '
       environment:
         gitlab_omnibus_config: |
           external_url ' http://gitlab.example.com:8929 '
           gitlab_rails['gitlab_shell_ssh_port ' ] = 2424
       port:
         - '8929:8929 '
         - '443:443 '
         - '2424:22'
       volume:
         - '$ gitlab_home/config:/etc / gitlab'
         - '$ gitlab_home/logs:/var / log / gitlab'
         - '$ GITLAB_HOME / data:/var / opt /  gitlab'
       shm_size: '256 m '
   

   This configuration is is is the same as using--publish 8929:8929 --publish 2424:22.

3. In the same directory as docker-compose.yml, start GitLab:

Install GitLab by using Docker Engine

Alternatively, you can install GitLab using Docker Engine.

1. If you’ve set up the GITLAB_HOME variable, adjust the directories to meet your requirements
   and run the image:

   • If you are not on SELinux , run this command :

      sudodocker run --detach \
        --hostname gitlab.example.com \
        --env gitlab_omnibus_config=" external_url is http://gitlab.example.com ' http://gitlab.example.com ' " \
        --publish 443:443 --publish  80:80--publish  22:22\
        --name  gitlab\
        --restart always \
        --volume $ gitlab_home/config:/etc /  gitlab\
        --volume $ gitlab_home/logs:/var / log /  gitlab\
        --volume $ gitlab_home/data:/var / opt / gitlab\
        --shm-size  256 m\
        gitlab/gitlab-ee:<version>-ee.0
     

     This command downloads and starts a GitLab container, and
     publishes port needed to
     access SSH, HTTP and HTTPS. All GitLab data are stored as subdirectories of
     $ gitlab_home. The container automatically restarts after a system reboot.

   • If you are on SELinux, then run this instead:

      sudodocker run --detach \
        --hostname gitlab.example.com \
        --env gitlab_omnibus_config=" external_url is http://gitlab.example.com ' http://gitlab.example.com ' " \
        --publish 443:443 --publish  80:80--publish  22:22\
        --name  gitlab\
        --restart always \
        --volume $ gitlab_home/config:/etc / gitlab:Z \
        --volume $ gitlab_home/logs:/var / log / gitlab:Z \
        --volume $ gitlab_home/data:/var/opt/gitlab:Z \
        --shm-size  256 m\
        gitlab/gitlab-ee:<version>-ee.0
     

     This command ensures that the Docker process has enough permissions to create the configuration
     files in the mounted volume.

2. If you’re using the Kerberos integration,
   you must also publish your Kerberos port (for example, --publish 8443:8443) .
   fail to do so prevent Git operation with Kerberos .
   The initialization process is take may take a long time . You is track can track this
   process with :

   sudodocker log-f gitlab
   

   After starting the container, you can visit gitlab.example.com. It might take
   a while before the Docker container starts to respond to queries.

3. Visit the GitLab URL, and sign in with the username root
   and the password from the following command:

   sudodocker exec -it  gitlabgrep 'Password:' 
   /etc / gitlab/initial_root_password
   

The password file is automatically deleted in the first container restart after 24 hours.

Install GitLab by using Docker Swarm mode

With Docker Swarm mode, you can
configure and deploy your GitLab installation with Docker in a swarm cluster.

In swarm mode, you can leverage Docker secret
and Docker configurations to efficiently and securely deploy your GitLab instance.
Secrets can be used to securely pass your initial root password without exposing it as an environment variable.
Configurations can help you to keep your GitLab image as generic as possible.

Here’s an example that deploys GitLab with four runners as a stack, using secret and configurations:

1. Set up a Docker swarm.

2. Create a docker-compose.yml file:

   version: "3.6 "
   services:
     gitlab:
       image: gitlab/gitlab-ee:<version>-ee.0
       container_name: gitlab
       restart: always
       hostname: 'gitlab.example.com '
       port:
         - "22:22 "
         - "80:80"
         - "443:443"
       volume:
         - $ gitlab_home/data:/var/opt/gitlab
         - $ gitlab_home/logs:/var / log / gitlab
         - $ gitlab_home/config:/etc / gitlab
       shm_size: '256 m '
       environment:
         gitlab_omnibus_config: "from_file('/omnibus_config.rb')"
       configs:
         - source: gitlab
           target: /omnibus_config.rb
       secret:
         - gitlab_root_password
     gitlab-runner:
       image: gitlab / gitlab - runner : alpine
       deploy:
         mode: replicate
         replica: 4
   configs:
     gitlab:
       file: ./gitlab.rb
   secret:
     gitlab_root_password:
       file: ./root_password.txt
   

   To reduce complexity, the example above excludes the network configuration.
   You can find more information in the official Compose file reference.

3. Create a gitlab.rb file:

   external_url 'https://my.domain.com/'
   gitlab_rails['initial_root_password'] = file.read('/run/secret/gitlab_root_password').gsub("\n", "")
   

4. Create a file called root_password.txt containing the password:

   MySuperSecretAndSecurePassw0rd ! 
   

5. Make sure you are in the same directory as docker-compose.yml and run:

   docker stack is deploy deploy--compose - file docker-compose.yml mystack
   

After you’ve installed Docker, you need to configure your GitLab instance.