--- title: Charmhub | Deploy GitHub runner using Charmhub - The Open Operator Collection description: Deploy the latest version of GitHub runner on any cloud. url: https://charmhub.io/github-runner/docs/local-lxd-how-to-configure-runner-storage --- # GitHub runner [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: 24.04 22.04 20.04 stable 24801f1f ``` juju deploy github-runner ``` [Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications) --- #### Contacts ##### Maintainers + [Launchpad Team](https://launchpad.net/~canonical-is-devops) * [Submit a bug](https://github.com/canonical/github-runner-operator/issues) --- Share your thoughts on this charm with the community on discourse. [Join the discussion](https://discourse.charmhub.io/) # How to configure runner storage To prevent the GitHub Action job from exhausting the disk IO of the Juju machine hosting the charm, the charm provides two storage options to be configured as the LXD instance root disk: * Random access memory as disk * Storage provided by Juju This is configured with the [`runner-storage`](https://charmhub.io/github-runner/configure#runner-storage) option. The configuration should be set during deployment and cannot be changed. ## [Random access memory as disk](https://charmhub.io/github-runner/docs/local-lxd-how-to-configure-runner-storage#p-36515-random-access-memory-as-disk) The random access memory of the Juju machine is configured as LXD storage and used as the root disk for the LXD instances. The `runner-storage` configuration needs to be set to `memory` during deployment, and the Juju machine constraints should have enough memory for the virtual machine memory and disk. See [Managing resource usage](https://charmhub.io/github-runner/docs/local-lxd-tutorial-managing-resource-usage). An example deployment: ``` juju deploy github-runner --channel=local-lxd/stable --constraints="cores=4 mem=16G root-disk=20G virt-type=virtual-machine" --config token= --config path= --config runner-storage=memory --config vm-memory=2GiB --config vm-disk=10GiB ``` ## [Storage provided by Juju](https://charmhub.io/github-runner/docs/local-lxd-how-to-configure-runner-storage#p-36515-storage-provided-by-juju) The Juju storage needs to be mounted during deployment, and the `runner-storage` configuration should be set to `juju-storage` during deployment. An example deployment: ``` juju deploy github-runner --channel=local-lxd/stable --constraints="cores=4 mem=6G root-disk=30G virt-type=virtual-machine" --config token= --config path= --config runner-storage=juju-storage --config vm-memory=2GiB --config vm-memory=10GiB --storage runner=rootfs ``` The above example uses `rootfs`, which is using the root disk of the Juju machine. Hence the root-disk size was increase to 30G. ---