Well, shell runner executes task on the machine where it’s installed - that’s why it’s very limiting. What I normally use is docker executor, even for executing tasks on different machines. For example, I install and configure ssh, copy anything I need to target machine, ssh into target machine and… Answer from paula.kokic on forum.gitlab.com
🌐
GitLab
docs.gitlab.com › gitlab docs › install › install gitlab runner
Install GitLab Runner | GitLab Docs
GitLab Runner runs the CI/CD jobs defined in GitLab. GitLab Runner can run as a single binary and has no language-specific requirements. For security and performance reasons, install GitLab Runner on a machine separate from the machine that hosts your GitLab instance.
GitLab Docs
Learn how to use and administer GitLab, the most scalable Git-based fully integrated platform for software development.
Upgrade GitLab
Upgrade a GitLab instance to a later version. ... Steps to take before you upgrade. ... Upgrade steps for all installation methods.
Configure GitLab Runner
The init system: GitLab Runner installs its init service files based on your operating system.
Docker
The versions for the Docker Engine ... to match. The GitLab Runner images are backwards and forwards compatible. To ensure you have the latest features and security updates, you should always use the latest stable Docker Engine version. ... You have installed Docker...
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › administer gitlab runner › getting started
Get started with GitLab Runner | GitLab Docs
GitLab Runner administration encompasses the complete lifecycle of managing your CI/CD job execution infrastructure: ... You manage runner access through scopes and tags, monitor performance, and maintain the runner fleet. Install GitLab Runner to create the application that executes CI/CD jobs.
Discussions

Where should you install gitlab-runner?
For example, you have a few servers with different environments like test, and prod. And you want to apply GitLab CI/CD, should you install gitlab-runner on each server or install it on a separate machine. Which one is better or are there any so-called best practices. More on forum.gitlab.com
🌐 forum.gitlab.com
4
0
January 31, 2024
Do I have to install gitlab-runner on all instances?
You should use SSH-keys which are stored in Gitlab CI secret variables / environment variables, then connect to your servers and deploy. I suggest using ansible for this purpose. Do not install the CI runner on any of your servers, keep it on a separate box. More on reddit.com
🌐 r/devops
13
6
March 5, 2019
Confused about Gitlab runners
I don't want to run my code, I just want to compile it The executor executes your build script, compiling is the stuff you would put in your build script. So no, it's not really for running your actual application. Docker is useful for this because it's isolated, you could also run it directly on your machine but setting up build environments manually sucks. It's better to invest a bit of time to find / create docker images you can use for your builds. For popular tools, many have official docker images anyway. It's not a stupid restriction, I have set up both runners using the shell (or whatever it's called exactly) and docker and both were painless & fast to set up and use. More on reddit.com
🌐 r/devops
22
0
June 18, 2021
#5: How to Install GitLab Runner on Amazon Linux 2 | Register GitLab Run...
i always have the issue of starting the runner with systemctl gitlab-runner start , it just freezes or it didn't work, every time I start it in background with gitlab-runner run &, any idea ? More on reddit.com
🌐 r/gitlab
1
4
August 31, 2021
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › administer gitlab runner
GitLab Runner | GitLab Docs
GitLab-hosted runners are managed by GitLab and available on GitLab.com. You don’t need to install or maintain these runners - GitLab provides them as a service.
🌐
DEV Community
dev.to › cheulong › install-gitlab-runner-self-host-4f40
Install Gitlab runner (self-host) - DEV Community
August 9, 2025 - ### register runner gitlab-runner register --name my-runner --url "http://gitlab.example.com" --token my-authentication-token ### list all runner gitlab-runner list ### verify runner gitlab-runner verify ### remove old runner gitlab-runner verify --delete ### unregister runner gitlab-runner unregister --name test-runner or gitlab-runner unregister --url "http://gitlab.example.com/" --token t0k3n gitlab-runner unregister --all-runners ### Other gitlab-runner reset-token --name test-runner gitlab-runner install gitlab-runner uninstall gitlab-runner start gitlab-runner stop gitlab-runner restart gitlab-runner status # Run with systemctl systemctl start gitlab-runner.service
🌐
GitLab
forum.gitlab.com › gitlab ci/cd
Where should you install gitlab-runner? - GitLab CI/CD - GitLab Forum
January 31, 2024 - For example, you have a few servers with different environments like test, and prod. And you want to apply GitLab CI/CD, should you install gitlab-runner on each server or install it on a separate machine. Which one is b…
🌐
GitLab
docs.gitlab.com › gitlab docs › install › install gitlab runner › macos
Install GitLab Runner on macOS | GitLab Docs
The gitlab-runner install command creates a LaunchAgent plist at ~/Library/LaunchAgents/gitlab-runner.plist and registers it with launchctl.
Find elsewhere
🌐
GeeksforGeeks
geeksforgeeks.org › linux-unix › setting-up-gitlab-runner-in-ubuntu
How to Install GitLab Runner on Ubuntu? - GeeksforGeeks
July 23, 2025 - GitLab Runner isn't included in the usual list of software for Ubuntu. We need to add its special place called a repository. ... We need to install something called curl to help us with the installation.
🌐
GitLab
docs.gitlab.com › gitlab docs › install › install gitlab runner › linux
Install GitLab Runner using the official GitLab repositories | GitLab Docs
If you attempt to install a specific version of gitlab-runner without installing the same version of gitlab-runner-helper-images, you might encounter the following error: sudo apt install gitlab-runner=17.7.1-1 ...
🌐
YouTube
youtube.com › devops hint
How to install GitLab Runner on Windows OS | Register GitLab Runner Windows | GitLab CI/CD Tutorial - YouTube
How to Install Gitlab Runner on Windows | Register GitLab Runner Windows | GitLab CI/CD | GitLab Runner Tutorial#gitlabrunner #gitlabcicd #gitlabtutorial #gi...
Published: July 17, 2023
Views: 3K
🌐
Aldec
aldec.com › support › resources › documentation › application notes › gitlab instance installation and configuration
GitLab Instance Installation and Configuration - Application Notes - Documentation - Resources - Support - Aldec
Before calling the system package ... -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash sudo apt-get install gitlab-runner...
🌐
Skynats
skynats.com › blog › how-to-install-and-register-gitlab-runner
Install and Register GitLab Runner – Quick Start Guide
August 28, 2025 - GitLab Runner is an open-source project used to run your jobs and send the results back to GitLab. Install GitLab Runner from the official repository
🌐
Medium
medium.com › @seremwen › installing-gitlab-runner-on-a-linux-server-a-step-by-step-guide-d3ecae3f564a
Installing GitLab Runner on a Linux Server: A Step-by-Step Guide | by Seremwe Ngoni | Medium
November 19, 2023 - # Install required dependencies sudo apt-get update sudo apt-get install -y curl # Download and install GitLab Runner curl -L…
🌐
Medium
kyosenaharidza.medium.com › how-to-create-your-own-gitlab-runner-a37cd54bae33
How to Create Your Own Gitlab Runner! | by Kyo | Medium
June 7, 2021 - #For debian or ubuntu dpkg -i gitlab-runner_<arch>.deb#For CentOS or Red Hat Enterprise Linux rpm -i gitlab-runner_<arch>.deb · Once you’ve installed gitlab-runner on your system, you now have to register it as a runner.
🌐
Hostman
hostman.com › tutorials › installing-and-using-gitlab-runner
Setting Up and Utilizing GitLab Runner | Hostman
The main thing is that there is network communication between GitLab Runner and the GitLab server. You can install Gitlab Runner on operating systems such as Linux, Windows, macOS, and it also supports running in a Docker container.
🌐
Medium
medium.com › @shanmorton › newbie-getting-started-with-gitlab-runner-ci-d8ef2cd70f7c
Getting started with GitLab-Runner CI. | by Shandra Morton | Medium
September 26, 2020 - On your local machine create a directory named “GitLab-Runner”, and change into that directory. I’m not sure it matters where on the drive you create the folder. Per the install directions, I did make the directory at the root of C:\
🌐
RackNerd
blog.racknerd.com › home › how to install and configure a gitlab runner?
How to Install and Configure a GitLab Runner? — RackNerd
May 2, 2023 - # Linux x86 sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386
🌐
Baeldung
baeldung.com › home › devops › guide to gitlab runner
Guide to GitLab Runner | Baeldung on Ops
May 31, 2024 - This short snippet downloads the installation script for the GitLab Runner repository and executes it using bash with superuser privileges.