The Charm Store will undergo scheduled database maintenance on July 5, 2026 22:00 to July 6, 02:00 UTC. During this time, you may be unable to access charm and bundle metadata or publish updates. No user action is required and services will automatically resume once maintenance is complete.

Github runner image builder

Canonical IS DevOps Publisher

Platform:

Ubuntu
22.04
Channel Revision Published Runs on
latest/stable 155 20 Mar 2026
Ubuntu 22.04
latest/stable 1 09 May 2024
Ubuntu 22.04
latest/beta 145 23 Feb 2026
Ubuntu 22.04
latest/edge 163 12 Jun 2026
Ubuntu 22.04
latest/edge 56 06 Feb 2025
Ubuntu 22.04 
juju deploy github-runner-image-builder

Learn to deploy on juju >

Relevant links

Contacts

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

Join the discussion

How to configure base-image

By default, github-runner-image-builder uses the noble Ubuntu OS base. To choose a different base, you can use the base-image configuration option.

BASE_IMAGE=jammy
OPENSTACK_AUTH_URL=<openstack-auth-url, e.g. http://my-openstack-deployment/openstack-keystone>
OPENSTACK_PASSWORD=<openstack project password>
OPENSTACK_PROJECT_DOMAIN_NAME=<openstack project domain name>
OPENSTACK_PROJECT_NAME=<openstack project name>
OPENSTACK_USER_DOMAIN_NAME=<openstack user domain name>
OPENSTACK_USERNAME=<openstack username>

juju deploy github-runner-image-builder \
--config base-image=$BASE_IMAGE
--config openstack-auth-url=$OPENSTACK_AUTH_URL \
--config openstack-password=$OPENSTACK_PASSWORD \
--config openstack-project-domain-name=$OPENSTACK_PROJECT_DOMAIN_NAME \
--config openstack-project-name=$OPENSTACK_PROJECT_NAME \
--config openstack-user-domain-name=$OPENSTACK_USER_DOMAIN_NAME \
--config openstack-user-name=$OPENSTACK_USERNAME

Currently, focal(20.04), jammy (22.04), and noble (24.04) are supported. Note: Yarn is not pre-installed for focal images.

Help improve this document in the forum (guidelines). Last updated 1 year, 3 months ago.