You can interact directly with your builds by connecting to the runner over SSH. This is helpful for troubleshooting your manifests, or just getting a quick temporary environment to test something in.

When a build fails, the VM stays alive for an extra ten minutes, and you'll be presented with instructions on how to connect to the runner via SSH, e.g.:

$ ssh -t builds@azusa.runners.sr.ht connect 81809
Connected to build job #81809 (failed):
https://builds.sr.ht/jobs/~sircmpwn/81809
Your VM will be terminated 4 hours from now, or when you log out.

bash-5.0 $

In addition to connecting to failed builds over SSH, you can add shell: true to your manifest to always enable SSH access. Then, you'll be able to interact with your build as it runs.

About this wiki

commit b345d3de11bc0e7dbf344de75c30cf7e3620fa7b
Author: Conrad Hoffmann <ch@bitfehler.net>
Date:   2022-05-12T10:04:02+02:00

Add link to package installation instructions

Besides being a bit more convenient, it also adds a little emphasis to
this specific bullet point :)
Clone this wiki
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)