MyNixOS website logo
option

services.github-runners.<name>.ephemeral

If enabled, causes the following behavior:

  • Passes the --ephemeral flag to the runner configuration script
  • De-registers and stops the runner with GitHub after it has processed one job
  • On stop, systemd wipes the runtime directory (this always happens, even without using the ephemeral option)
  • Restarts the service after its successful exit
  • On start, wipes the state directory and configures a new runner

You should only enable this option if tokenFile points to a file which contains a personal access token (PAT). If you're using the option with a registration token, restarting the service will fail as soon as the registration token expired.

Changing this option triggers a new runner registration.