Mirror | Please open new issues in our issue tracker on GitLab.com
Switch branches/tags
0-6-stable 0-7-stable 1-0-stable 1-1-stable 1-2-stable 1-3-stable 1-4-stable 1-5-stable 1-6-stable 1-7-stable 1-8-stable 1-9-stable 1-10-stable 1-11-stable 9-0-stable 9-1-stable 9-2-stable 9-3-stable 9-4-stable 9-5-stable 10-0-stable 10-1-stable 10-2-stable 10-3-stable 10-4-stable 10-5-stable-prepare-rc2 10-5-stable 1197-the-packages-for-gitlab-ci-multi-runner-on-gitlab-com-are-unsigned 2742-kubernetes-client-4.0.0 2922-data-race-in-function-executors-virtualbox_test-testvirtualboxbuildcancel-func1-executors-virtualbox-executor_virtualbox_test-go-194 ac-fix-windows-build ac-win-tests accept-hostname-ports-in-images adam-run-tests-locally add-network-alias-of-services auth-config bjk/failure_metrics bjk/listen_address bjk/metrics caching cc-failure-example cc-failure certificate-chain cpu-profile credentials-store-support credentials debian-packages debug-docker-client-casting-issue deprecate-docker-api-before-1-24 docker-ci-image/switch-to-go-1-9-4 docker-ci-image/upgrade-packagecloud-gem docker-ci-image/use-go-1.8 docker-image-not-found-regexp docs/autoscale-fixes drop-kubernetes-experimental-notice feature/add-no-collor-option feature/add-project-name-variables feature/dont-upload-empty-artifacts feature/info-command feature/licenses-check feature/metrics/jobs-failure-tracking feature/mount-volumes-to-services feature/recurent-index-lock-deletion feature/restore-mirror-step-in-pipeline feature/services-logs feature/stats-server fix/bash-paths-on-windows fix/close-docker-sockets fix/force-disconnect-stale-container-from-network fix/network-client-timeout-settings fix/process-killing-bug fix/services-from-non-standard-registry flaky-tests gl-gitlab-triage-policies goimports haynes/gitlab-ci-multi-runner-add-proxy-documentation improve-check-interval-docs improvement/add-uptime-metric improvement/register-error-handling improvement/timeouts-for-cache-operations inject-git-ssl-ca-info log-level-in-config-toml make-docker-concurrent master mount-user-volumes-to-services no-go-bindata patch-1 prepare-build-current-docker-make-target pty-wip refactor-docker-executor refactor-docker-machine-calls refactor-k8s-config remove-single-command-tests review-docs scaling-v2 sh-add-git-lfs-support syscall td-http-status-constants test-vendor-cleanup test/check-why-dind-service-is-not-working tmpfs_docker update-exec-command-status update-license-and-add-dco upgrade-testify yaml
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitlab Update release checklist issue template Oct 31, 2018
apps/gitlab-runner-helper Specify logger explicitly when using AddSecretsClenupLogHook Oct 3, 2018
cache Unable escaping project bucket in cache operations Sep 24, 2018
ci Don't use cache when building official Docker images Oct 29, 2018
commands Merge branch 'refactor-and-improve-testing-of-log-package' into 'master' Oct 23, 2018
common Fix instantization in the test Oct 31, 2018
dockerfiles Install go-junit-report in the base CI image Oct 18, 2018
docs Merge branch 'docs-session-server-index' into 'master' Dec 12, 2018
executors Make k8s object names DNS-1123 compatible Dec 6, 2018
helpers Merge branch 'refactor-and-improve-testing-of-log-package' into 'master' Oct 23, 2018
log Refactor and improve tests for SystemServiceLogHook Oct 22, 2018
network CI Web Terminal Aug 14, 2018
packaging Remove go-bindata Jun 27, 2018
scripts Count CI_NODE_INDEX from 1, not from 0 Nov 21, 2018
session Merge branch '3639-follow-up-from-resolve-add-docker-support-for-inte… Oct 17, 2018
shells Add tests for raw file formats Oct 16, 2018
tests Merge branch '2815-ac-remove-hardcoded-cert' into 'master' Oct 21, 2017
vendor Add web terminal for docker executor Oct 5, 2018
.codeclimate.yml Merge branch 'docker-prefer-to-always-create-containers' into 'master' Feb 15, 2018
.dockerignore Updated develop Dockerfile Oct 6, 2015
.env Multi runner can run jobs on Heroku Mar 10, 2015
.gitignore Parallelize tests execution Aug 1, 2018
.gitlab-ci.yml Add explanation why the job is being disabled Dec 11, 2018
CHANGELOG.md Update CHANGELOG for v11.5.0 Nov 22, 2018
CONTRIBUTING.md Add ~"git operations" label to CONTRIBUTING guide Jun 25, 2018
Dockerfile Update Go from 1.8.5 to 1.8.7 Apr 4, 2018
Gopkg.lock Add web terminal for docker executor Oct 5, 2018
Gopkg.toml Add web terminal for docker executor Oct 5, 2018
LICENSE Change docs license to CC BY-SA 4.0 May 4, 2018
Makefile Add values autodetection to the Release Checklist issue generator Oct 31, 2018
Makefile.docker.mk Remove go-bindata Jun 27, 2018
NOTICE Replace CLA with DCO + License Nov 20, 2017
Procfile Rename 1st iteration: configuration, build scripting etc. Sep 11, 2017
README.md Add note on the branch naming for documentation changes Dec 11, 2018
VERSION Bump version to 11.6.0 Nov 8, 2018
config.toml.example Allow disabling docker entrypoint overwrite Oct 1, 2018
install.sh Upload artefacts to S3 Apr 19, 2015
main.go Move logging helpers and configuration to dedicated package Oct 3, 2018


GitLab Runner

This is the repository of the official GitLab Runner written in Go. It runs tests and sends the results to GitLab. GitLab CI is the open-source continuous integration service included with GitLab that coordinates the testing. The old name of this project was GitLab CI Multi Runner but please use "GitLab Runner" (without CI) from now on.

Build Status

Runner and GitLab CE/EE compatibility

For a list of compatible versions between GitLab and GitLab Runner, consult the compatibility chart.

Release process

The description of release process of GitLab Runner project can be found in the release documentation.


Contributions are welcome, see CONTRIBUTING.md for more details.

Closing issues and merge requests

GitLab is growing very fast and we have a limited resources to deal with reported issues and merge requests opened by the community volunteers. We appreciate all the contributions coming from our community. But to help all of us with issues and merge requests management we need to create some closing policy.

If an issue or merge request has a ~"waiting for feedback" label and the response from the reporter has not been received for 14 days, we can close it using the following response template:

We haven't received an update for more than 14 days so we will assume that the
problem is fixed or is no longer valid. If you still experience the same problem
try upgrading to the latest version. If the issue persists, reopen this issue
or merge request with the relevant information.

Contributing to documentation

If your contribution contains only documentation changes, you can speed up the CI process by following some branch naming conventions, as described in https://docs.gitlab.com/ce/development/documentation/index.html#branch-naming


The documentation source files can be found under the docs/ directory. You can read the documentation online at https://docs.gitlab.com/runner/.


Read about the requirements of GitLab Runner.


Read about the features of GitLab Runner.

Executors compatibility chart

Read about what options each executor can offer.

Install GitLab Runner

Visit the installation documentation.

Use GitLab Runner

See https://docs.gitlab.com/runner/#using-gitlab-runner.

Select executor

See https://docs.gitlab.com/runner/executors/#selecting-the-executor.


Read the FAQ.

Advanced Configuration

See https://docs.gitlab.com/runner/#advanced-configuration.

Building and development

See https://docs.gitlab.com/runner/development/.


Visit the Changelog to view recent changes.

The future

  • Please see the GitLab Direction page.
  • Feel free submit issues with feature proposals on the issue tracker.


2014 - 2015   : [Kamil Trzciński](mailto:ayufan@ayufan.eu)
2015 - now    : GitLab Inc. team and contributors


This code is distributed under the MIT license, see the LICENSE file.