---
title: Charmhub | Deploy gitlab-runner using Charmhub - The Open Operator Collection
description: Deploy the latest version of gitlab-runner on any cloud. A gitlab-runner
  charm.
url: https://charmhub.io/gitlab-runner
---

# gitlab-runner

[Erik Lönroth](https://charmhub.io/publisher/erik-lonroth "View all packages from Erik Lönroth")

* [Erik Lönroth](https://charmhub.io/publisher/erik-lonroth "View all packages from Erik Lönroth")

Platform:

22.04

20.04

18.04

stable 9

```
juju deploy gitlab-runner
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Contact](mailto:Erik Lönroth <erik.lonroth@gmail.com>)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

The gitlab-runner charm:

* Installs gitab-runner upstream repos as described here:
  <https://docs.gitlab.com/runner/install/>
* Configures and registers a single docker or lxd runner using the configured gitlab-registration-token and gitlab-server.
* Exposes prometheus metrics on port: 9252

The runner registers with its hostname (fqdn) in gitlab (default with gitlab-runner) and any supplied tags.

A default “juju” tag is added unless changed.

The runner removes itself and unregisters as part of a unit removal with ‘juju remove unit’.

# Attribution

This charm was inspired and code was used from the “pirate-charmers” which implemented the lxd custom runner.

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/gitlab-runner-docs-index/4581) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 2 years ago.