DEV Community

Cover image for Gitlab - Runner Setup
Vecha Sumanth
Vecha Sumanth

Posted on • Edited on

2 2 1

Gitlab - Runner Setup

The Runner is a super important part of the GitLab ecosystem. Builds, tests, deployments — you name it, and the Runner’s got you covered.

In simple terms, Runners are agents that execute GitLab CI/CD jobs in your pipeline. So if you're setting up GitLab in a meaningful way, you'll definitely need one. Fortunately, installing a Runner is pretty straightforward—just like setting up the GitLab server.

Step 1 : Setup Docker Dependencies

yum install containerd.io docker-ce-cli docker-ce
systemctl daemon-reload
systemctl enable --now docker
Enter fullscreen mode Exit fullscreen mode

Step 2 : Setup Gitlab Runner Repository

curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo -E bash
Enter fullscreen mode Exit fullscreen mode

Step 3 : Install Gitlab Runner

yum -y --disablerepo='*' --enablerepo='gitlab_gitlab-runner' install gitlab-runner-17.10.1-1.x86_64
Enter fullscreen mode Exit fullscreen mode

Step 4: Register the Runner

  • Head over to http://<YOUR_GITLAB_URL>/admin/runners
  • Click New Instance Runner
  • Enable Run untagged jobs and Paused
  • Hit Create Runner to generate your token
gitlab-runner register --non-interactive --url {GITLAB_URL} --token {RUNNER_TOKEN} --description "{RUNNER_NAME}" --executor docker

Enter fullscreen mode Exit fullscreen mode

Go to Gitlab - http:///admin/runners and check for the new runner.

Congratulations! You've successfully created your Runner!

In case you got stuck somewhere, feel free to drop a comment — I’ll try to answer as best as I can.

You can also checkout gitlab forum for any additional help or queries.

Image of Datadog

Optimize UX with Real User Monitoring

Learn how Real User Monitoring (RUM) and Synthetic Testing provide full visibility into web and mobile performance. See best practices in action and discover why Datadog was named a Leader in the 2024 Gartner MQ for Digital Experience Monitoring.

Tap into UX Best Practices

Top comments (1)

Collapse
 
nevodavid profile image
Nevo David

i would say guides like this actually help me not overthink the setup stuff - solid

ACI image

ACI.dev: Best Open-Source Composio Alternative (AI Agent Tooling)

100% open-source tool-use platform (backend, dev portal, integration library, SDK/MCP) that connects your AI agents to 600+ tools with multi-tenant auth, granular permissions, and access through direct function calling or a unified MCP server.

Star our GitHub!

👋 Kindness is contagious

Engage with a wealth of insights in this thoughtful article, cherished by the supportive DEV Community. Coders of every background are encouraged to bring their perspectives and bolster our collective wisdom.

A sincere “thank you” often brightens someone’s day—share yours in the comments below!

On DEV, the act of sharing knowledge eases our journey and forges stronger community ties. Found value in this? A quick thank-you to the author can make a world of difference.

Okay