# So funktioniert Skipbox

> Was zwischen einem Push und einem fertigen Job passiert: der Webhook, die Prüfungen, ein Runner für einen einzigen Job, deine dedizierte Maschine oder eine frische VM und was nach dem Job passiert.

Skipbox führt deine GitHub-Actions-Jobs auf selbstgehosteten Runnern aus, die es für dich verwaltet. GitHub führt weiterhin deine Workflows aus, behält deine Logs und zeigt die Ergebnisse. Skipbox stellt nur die Maschine, auf der jeder Job läuft.

## Vom Push zum fertigen Job

1. Ein Job, dessen `runs-on` ein Skipbox-Label verlangt, kommt auf GitHub in die Warteschlange.
2. GitHub benachrichtigt Skipbox über den Webhook der App.
3. Skipbox prüft den Job: Das Konto braucht einen Tarif oder seine Testphase, mit Platz für einen weiteren Job dieser Größe. Tarif S führt bis zu 8 Jobs gleichzeitig aus, je 4 vCPU · 16 GB. Immer aktiv: Jobs, die jederzeit laufen, den ganzen Monat, mit unbegrenzten Minuten. Tarif S: 1, M: 2, L: 4. Burst: Weitere Jobs laufen gleichzeitig auf anderen von Skipbox gehosteten Maschinen, wenn eine frei ist, bis zu 7 auf einmal. Pro Tarif sind 10.000 Minuten je Kalendermonat enthalten. Ein Burst-Job startet auf einer frischen Maschine mit dem GitHub-Actions-Cache; die Maschine deines Tarifs behält ihre warmen Caches. Sind die Burst-Minuten eines Monats verbraucht, laufen bis zum 1. nur die immer aktiven Jobs des Tarifs; dann ist Burst wieder da. Siehe [Parallelität und Warteschlange](https://docs.skipbox.dev/de/concurrency).
4. Skipbox fordert bei GitHub eine Runner-Registrierung an, die einen einzigen Job annimmt, mit den eigenen Labels des Jobs.
5. Der Runner geht auf die dedizierte Maschine deiner Organisation oder auf eine frische VM (siehe [VM-Isolation](https://docs.skipbox.dev/de/isolation)). Er nimmt einen Job mit diesen Labels an, und GitHub schickt ihm deinen Code, die Secrets, die dein Workflow übergibt, und ein Token für den Job.
6. Wenn der Job endet, löscht deine dedizierte Maschine die Zugangsdaten des Runners und die Git-Zugangsdaten im Checkout des Jobs und prüft sich selbst. Sie behält ihre Caches und ab dem 13. November 2026 auch den Checkout und seine Build-Ausgabe (`target/` von Cargo und `.next/cache` von Next.js); eine frische VM wird mit ihrer Festplatte gelöscht. Ein noch registrierter Runner wird entfernt.

## Was gleich bleibt

- Deine Workflows, Actions und Logs bleiben auf GitHub. Skipbox behält keine Kopie deines Codes oder deiner Logs. Es ändert einen Workflow nur über einen Pull Request, den du anforderst und mergst (siehe [Berechtigungen der GitHub-App](https://docs.skipbox.dev/de/permissions)).
- Einen Job zu verschieben ist eine Zeile: sein `runs-on`. Ihn zurückzuverschieben ist dieselbe Zeile.
- Jobs, deren `runs-on` du nicht änderst, laufen weiter auf den Runnern von GitHub.

## Wo Jobs laufen

Deine dedizierte Maschine und frische VMs laufen auf einem Server, den Skipbox in Japan betreibt, und auf Servern von Hetzner Cloud in Finnland und Deutschland (EU). Frische VMs laufen auch auf Servern von Google Cloud in Kanada und in Frankreich, Spanien und Italien (EU). Siehe [Netzwerk und ausgehender Verkehr](https://docs.skipbox.dev/de/network).

## Ein Job nach dem anderen

Eine VM führt einen Job nach dem anderen aus. Deine dedizierte Maschine bleibt mit ihren Caches für den nächsten Job deiner Organisation erhalten. Code von Personen ohne Schreibzugriff (etwa Pull Requests aus Forks) läuft nie auf ihr: Er bekommt eine frische VM, die deine Caches liest, aber nicht ändern kann. Schalte „Frische VM für jeden Job“ ein, um jedem Job eine frische VM zu geben. Ein Job kann bis zu 6 Stunden laufen: Siehe [Zeitlimit für Jobs](https://docs.skipbox.dev/de/job-time-limit). Wie die VMs voneinander getrennt werden: [VM-Isolation](https://docs.skipbox.dev/de/isolation).

Aktualisiert am 2026-11-20 · https://docs.skipbox.dev/de/how-it-works
