wtf is kvm-github-actions-runner?

This project lets you run GitHub Actions automation on your own servers using self-contained virtual machines, rather than relying on GitHub's shared cloud infrastructure. GitHub Actions is a service that automatically runs tasks like software tests and builds whenever code changes are submitted. By hosting these runners yourself, you keep full control over the computing environment and any sensitive data involved. The system works by spinning up multiple lightweight virtual machines on a single physical server. First, you build a base operating system image for these virtual machines. Then, you run a setup script that connects everything to your GitHub account using a personal access token, so GitHub knows your servers are available to pick up work. Each virtual machine is configured with a set amount of computing power and memory, by default, two virtual processors and 7 GB of RAM. When GitHub needs to run an automated task, it sends the job to one of your available virtual machines, which executes it in isolation and reports the results back. This setup is designed for engineering teams that need more power, privacy, or customization than standard GitHub-hosted runners provide. For example, a company running tests that require access to an internal database hosted on a private network could use this to keep everything in-house. Similarly, teams that hit usage limits on GitHub's standard plans can scale horizontally by adding more virtual workers to their own hardware. The system supports running multiple workers in parallel, the README shows examples with eight, so several jobs can run at the same time on one machine. The project is built entirely with shell scripts and relies on standard Linux virtualization tools. Maintenance is straightforward: creating a specific temporary file puts a worker into "draining" mode, meaning it finishes current jobs but won't accept new ones, allowing for safe updates. The README includes several debugging commands for managing the virtual machines directly, including stopping, removing, or accessing their text-based consoles.