Post

Install Local GitLab Server on Docker

Install Local GitLab Server on Docker

Prerequisities

Operating SystemMacOS
OS ArchitectureArm64
ToolsDocker Desktop

Step-by-Step Instruction to install Gitlab on Docker

  1. Create a directory for the project:
    1
    2
    
     mkdir gitlab-on-docker
     cd gitlab-on-docker
    
  2. Check the Docker Desktop configuration to get the allowed virtual file shares:
    • Navigate to Docker Desktop App -> Settings -> Resources -> File Sharing -> Virtual File Shares

    Note: Add a custom path which will be used to store the Gitlab configuration and data (pipelines,env’s, variables, etc.)

  3. Create an .env file in the same directory and the below path to define the Gitlab home directory (should be one of the allowed file share in docker desktop):
    1
    
     export $GITLAB_HOME=/Users/<user-name>/gitlab-local
    
  4. Create a docker-compose.yml and add the below content:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    
     version: '3.6'
     services:
     gitlab:
         image: gitlab/gitlab-ee:latest
         container_name: gitlab
         restart: always
         hostname: 'localhost'
         environment:
         GITLAB_OMNIBUS_CONFIG: |
             # Add any other gitlab.rb configuration here, each on its own line
             external_url 'http://localhost'
         ports:
         - '80:80'
         - '443:443'
         - '22:22'
         volumes:
         - '/$GITLAB_HOME/config:/etc/gitlab'
         - '/$GITLAB_HOME/logs:/var/log/gitlab'
         - '/$GITLAB_HOME/data:/var/opt/gitlab'
         shm_size: '256m'
    
  5. Get the password sudo cat $GITLAB_HOME/config/initial_root_password

  6. Open the browser and navigate to https://localhost and you should land on the Gitlab Login page.
This post is licensed under CC BY 4.0 by the author.