To run GitLab in a Docker container, use a GitLab image, which contains all of the necessary services in a single container.

The official GitLab Enterprise Edition Docker image is available on Docker Hub⁠.

Step 3. Launch the gitlab container · docker run --name gitlab -d \ --link gitlab-postgresql:postgresql --link gitlab-redis:redisio \ --publish 10022:22 --publish 10080:80 \ --env 'GITLAB_PORT=10080' --env 'GITLAB_SSH_PORT=10022' \ --env 'GITLAB_SECRETS_DB_KEY_BASE=long-and-random-alpha-numeric-string' \ --env 'GITLAB_SECRETS_SECRET_KEY_BASE=long-and-random-alpha-numeric-string' \ --env 'GITLAB_SECRETS_OTP_KEY_BASE=long-and-random-alpha-numeric-string' \ --env 'GITLAB_SECRETS_ENCRYPTED_SETTINGS_KEY_BASE=long-and-random-alpha-numeric-string' \ --env 'GITLAB_SECRETS_ACTIVE_RECORD_ENCRYPTION_PRI

Discover official Docker images from GitLab. Visit their profile and explore images they maintain.

Build and push container images in GitLab CI/CD using the shell executor, Docker-in-Docker, socket binding, or pipe binding.

October 10, 2024 - If you need to access the GitLab server on your host machine from within the running container, you need to do the port mapping from host machine to the container by using -p 8000:80. On the host side, we are setting port to 8000. On the container side, its port 80 · Once you run the above docker run command, this could take around 5 minutes to set up the GitLab server inside the docker container.

Register a runner and configure it to use the Docker executor. Specify the container image where you want to run the CI/CD jobs in the .gitlab-ci.yml file.

The settings contained in GITLAB_OMNIBUS_CONFIG aren’t written to the gitlab.rb configuration file, and are evaluated on load. To provide multiple settings, separate them with a colon (;). The following example sets the external URL, enables LFS, and starts the container with a minimal shm size required for Prometheus: sudo docker run --detach \ --hostname gitlab.example.com \ --env GITLAB_OMNIBUS_CONFIG="external_url 'http://gitlab.example.com'; gitlab_rails['lfs_enabled'] = true;" \ --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 256m \ gitlab/gitlab-ee:<version>-ee.0

The official GitLab Enterprise Edition Docker image is available on Docker Hub⁠.

Run your CI/CD jobs in Docker containers.

The Docker executor uses Docker Engine to run each job in a separate and isolated container. To connect to Docker Engine, the executor uses: The image and services you define in .gitlab-ci.yml.

To use your local system for the configuration volume and other resources mounted into the gitlab-runner container: Optional. In MacOS systems, /srv does not exist by default. Create /private/srv, or another private directory, for setup. ... docker run -d --name gitlab-runner --restart always \ -v /srv/gitlab-runner/config:/etc/gitlab-runner \ -v /var/run/docker.sock:/var/run/docker.sock \ gitlab/gitlab-runner:latest

gitlab/gitlab-runner:latest is image that can be used to run GitLab Runner in container.

April 9, 2024 - Hello, In the GitLab Runner documentation it was written that it should be installed on a separate server from the GitLab server. 1- Can I install it alongside the Docker server or do I have to dedicate a separate serv…

GitLab is an open source end-to-end software development platform with built-in version control, issue tracking, code review, CI/CD, and more. Self-host GitLab on your own servers, in a...

OCI conformance introduced in GitLab 16.6. The container registry supports the Docker V2 and Open Container Initiative (OCI) image formats.

February 8, 2026 - This guide walks through deploying GitLab CE in Docker, configuring it for production use, setting up CI/CD runners, and handling backups.

Dockerfile to build a GitLab image for the Docker opensource container platform.

{ "mcpServers": { "gitlab": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITLAB_API_URL", "-e", "GITLAB_PERSONAL_ACCESS_TOKEN", "mcp/gitlab" ], "env": { "GITLAB_API_URL": "https://gitlab.com/api/v4", "GITLAB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" } } } } Copy

Once you've set up the GITLAB_HOME variable, you can run the image: sudo docker run --detach \ --hostname 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 256m \ gitlab/gitlab-ee:latest