---
title: Charmhub | Deploy Github runner image builder using Charmhub - The Open Operator
  Collection
description: Deploy the latest version of Github runner image builder on any cloud.
  Provide Github runners with images available to use.
url: https://charmhub.io/github-runner-image-builder
---

# Github runner image builder

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

22.04

stable 155

```
juju deploy github-runner-image-builder
```

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

---

#### Relevant links

* [Homepage](https://charmhub.io/github-runner-image-builder)
* [Contact](https://github.com/orgs/canonical/teams/is-charms)

---

#### Contacts

##### Maintainers

+ [https://github.com/orgs/canonical/teams/is-charms](mailto:https://github.com/orgs/canonical/teams/is-charms)

* [Submit a bug](https://github.com/canonical/github-runner-image-builder-operator/issues)

---

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

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

A [Juju](https://juju.is/) [charm](https://documentation.ubuntu.com/juju/3.6/reference/charm/) for building VM
images for [GitHub self-hosted runners](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners).

This charm simplifies the initial deployment and building images for GitHub self-hosted runners.

Some of the charm dependencies upgrades on a schedule to migrate security risks.
The [Landscape Client charm](https://charmhub.io/landscape-client) can be deployed with this charm to ensure other dependencies are up to date.

The charm operates a set of isolated single-use OpenStack virtual machines, to build up-to-date
images for GitHub runners.

This charm will make operating GitHub self-hosted runners simple and straightforward for DevOps or
SRE teams through Juju’s clean interface.

## [In this documentation](https://charmhub.io/github-runner-image-builder#p-33536-in-this-documentation)

|  |  |
| --- | --- |
| [Tutorials](https://charmhub.io/github-runner-image-builder/docs/tutorial-quick-start)  Get started - a hands-on introduction to using the GitHub runner image builder charm for new users | [How-to guides](https://charmhub.io/github-runner-image-builder/docs/how-to-configure-base-image)   Step-by-step guides covering key operations and common tasks |

## [Contributing to this documentation](https://charmhub.io/github-runner-image-builder#p-33536-contributing-to-this-documentation)

Documentation is an important part of this project, and we take the same open-source approach to the documentation as the code. As such, we welcome community contributions, suggestions and constructive feedback on our documentation. Our documentation is hosted on the [Charmhub forum](https://discourse.charmhub.io/t/github-runner-image-builder-documentation-overview) to enable easy collaboration. Please use the “Help us improve this documentation” links on each documentation page to either directly change something you see that’s wrong, ask a question, or make a suggestion about a potential change via the comments section.

If there’s a particular area of documentation that you’d like to see that’s missing, please [file a bug](https://github.com/canonical/github-runner-image-builder-operator/issues).

## [Project and community](https://charmhub.io/github-runner-image-builder#p-33536-project-and-community)

The GitHub runner image builder charm is a member of the Ubuntu family.It’s an open-source project that warmly welcomes community projects, contributions, suggestions, fixes, and constructive feedback.

* [Code of conduct](https://ubuntu.com/community/code-of-conduct)
* [Get support](https://discourse.charmhub.io/)
* [Join our online chat](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)
* [Contribute](https://github.com/canonical/github-runner-image-builder-operator/blob/main/CONTRIBUTING.md)

Thinking about using the GitHub runner image builder charm for your next project? [Get in touch](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)!

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/github-runner-image-builder-documentation-overview/15390) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 10 months ago.