Einen Cluster abkoppeln oder löschen

Du kannst jederzeit gehen, auf eine von zwei Arten. Detach (Abkoppeln) lässt den Cluster in deinem Projekt weiterlaufen und beendet die Verwaltung durch das Portal; Delete (Löschen) entfernt den Cluster und alles, was das Portal für ihn angelegt hat. Beides beendet die Abrechnung, und in beiden Fällen bleiben deine Snapshots in deinem Bucket.

In Arbeit: noch nicht buchbar

Gebaut im Labor: Am 2026-10-10 hat ein Löschen einen Cluster in 14 Sekunden aus einem echten Hetzner-Projekt entfernt, samt seinem Hetzner-Volume, und das Löschen eines Clusters auf einem übernommenen Server hat diesen Server in 23 Sekunden zurückgegeben. Abkoppeln, pbx-agent uninstall und die Abrechnung über Paddle sind In Arbeit: gebaut und gegen simulierte Gegenstellen getestet, auf einem echten Cluster noch nicht gelaufen. Die Oberfläche des Portals ist englisch, darum stehen ihre Beschriftungen hier auf Englisch. Sag mir, wenn es buchbar ist.

Was du wählst

	Abkoppeln	Löschen
Der Cluster	läuft weiter, unverwaltet	entfernt
Der Server	bleibt	gelöscht (ein übernommener wird zurückgegeben)
Daten auf der Platte des Servers	bleiben	weg (ein übernommener Server behält seine Platte)
Hetzner-Volumes des Volume-Add-ons	bleiben	gelöscht
Snapshots in deinem Bucket	bleiben, und k3s legt weiter neue an	bleiben
Der DNS-Name der API	bleibt 30 Tage	entfernt
Abrechnung	endet	endet

Die Abrechnung des Clusters endet, wenn du bestätigst. In Arbeit Paddle schreibt dir den Rest des Monats auf der nächsten Rechnung gut, außer beim letzten Cluster des Teams: Dann endet das Abo mit dem schon bezahlten Monat, und ein Cluster, den du vor dessen Ende anlegst, nutzt es weiter (Kosten und Abrechnung).

Was du brauchst

• Du bist Team-Admin. Beide Karten stehen auf Settings des Clusters, nur für Team-Admins.
• Den Namen des Clusters, den du zur Bestätigung eintippst.
• Vor dem Abkoppeln: was Ohne PaaSbox weiterbetreiben unter „Vor dem Abkoppeln” aufzählt, solange das Portal noch arbeitet.

Abkoppeln

1. Tipp auf Settings des Clusters unter Detach den Namen des Clusters ein.

2. Wähle Detach. Die Seite sagt „Detached. The cluster keeps running; the portal no longer manages it.”, und die Overview des Clusters zeigt das Datum, an dem sein DNS-Name verschwindet.

Was passiert:

• Das Portal widerruft pbx-agent. Er ruft das Portal nicht mehr an und ändert nichts mehr; er bleibt untätig auf dem Server, bis du ihn entfernst.
• Die Abrechnung endet.
• Der Cluster läuft unberührt in deinem Projekt weiter: Server, k3s, deine Workloads, Firewall und Netz bleiben, wie sie sind.
• k3s macht weiter die geplanten Snapshots und lädt sie in deinen Bucket, solange die Schlüssel im Secret kube-system/pbx-etcd-s3 des Clusters gültig bleiben.
• Der API-Name des Clusters bleibt 30 Tage, damit du auf einen eigenen Namen umziehen kannst. Danach entfernt ihn das Portal.

Niemand pflegt den Cluster mehr aus dem Portal: keine Upgrades, keine Kubeconfigs aus dem Portal, keine Wiederherstellungen. Ohne PaaSbox weiterbetreiben ist das Runbook für alles, was du ab dann tust.

pbx-agent vom Server entfernen

Auf dem Server, als root (Root auf dem Server bekommen):

pbx-agent uninstall          # zeigt, was es tun würde, ändert nichts
pbx-agent uninstall --yes    # tut es

Es schaltet die systemd-Unit von pbx-agent und seinen Rollback-Timer ab und entfernt sie, dazu /var/lib/pbx-agent und /etc/pbx-agent. k3s, seine Konfiguration und jedes Kubernetes-Objekt bleiben, wie sie sind.

Du kannst es auch ohne vorheriges Abkoppeln ausführen. Das Portal hört dann nichts mehr vom Server: Nach fünf Minuten wird der Cluster als agent not reporting markiert, nach 24 Stunden bekommen die Admins des Teams eine Mail In Arbeit, und die Abrechnung läuft weiter, bis du den Cluster im Portal abkoppelst oder löschst.

Löschen

1. Entscheide auf Settings des Clusters unter Delete über Take a final snapshot first (voreingestellt an). Ohne Bucket landete der letzte Snapshot auf der Platte des Servers, die mitgelöscht wird; nimm den Haken dann heraus.

2. Tipp den Namen des Clusters ein und wähle Delete cluster. Die Seite sagt „Deleting. Billing stopped now; the servers go in the next minutes.”

Was passiert, in dieser Reihenfolge:

1. Die Abrechnung endet, wenn du bestätigst.
2. Hast du einen letzten Snapshot gewollt, macht pbx-agent ihn und lädt ihn in deinen Bucket. Kommt der letzte Snapshot nicht binnen 15 Minuten, wird er übersprungen: Du wolltest löschen.
3. Das Portal widerruft pbx-agent.
4. Es löscht den Server, dann die Hetzner-Volumes des Volume-Add-ons (eines, das noch angehängt ist, wird vorher abgehängt), die primäre IP-Adresse, die Firewall, das private Netz und eine etwaige Placement Group, jedes über das Label pbx-cluster des Clusters gefunden, und danach den DNS-Namen der API.

Schlägt ein Schritt fehl, zeigt die Seite des Clusters den Schritt, und Retry from setzt das Löschen ab diesem Schritt fort; jeder Durchgang löscht, was er noch findet.

Was ein Löschen nicht anfasst:

• Den Inhalt deines Buckets. Jeder Snapshot bleibt.
• Das Node-Image in deinem Projekt. Andere Cluster im Projekt nutzen es; lösch es in der Hetzner-Konsole, wenn keiner mehr da ist.
• Einen Server, den du schon hattest. Ein übernommener Server wird nie gelöscht. Er verlässt das Netz des Clusters, verliert die Labels des Clusters und mit ihnen die Firewall des Clusters, und bekommt seinen alten Namen zurück. Er läuft weiter, wie er ist, mit dem System und den Daten des Clusters auf der Platte und ohne Firewall des Portals davor; Hetzner rechnet ihn weiter mit dir ab. Einen vorhandenen Server nutzen.
• Alles, was du selbst im Projekt angelegt hast, etwa eine eigene Firewall für SSH.

Daten auf einem gelöschten Server und auf den Hetzner-Volumes, die der Cluster angelegt hat, sind weg.

In Arbeit Ein Agent mit einem API-Schlüssel, der den Scope k3s:destructive hat, kann einen Cluster ebenfalls abkoppeln oder löschen, nur mit dem Namen des Clusters als Bestätigung. Einem Agenten Zugriff geben.

Wenn eine Rechnung unbezahlt bleibt

In Arbeit Eine unbezahlte Rechnung löscht nie etwas. Die Admins des Teams bekommen am Tag 1, 7 und 13 eine Mail. Nach 14 Tagen koppelt das Portal die Cluster des Teams ab: Sie laufen in deinem Projekt weiter, das Portal verwaltet sie nicht mehr, die Abrechnung endet, und ihre DNS-Namen verschwinden 30 Tage später. Solange eine Rechnung offen ist, kann das Team keinen neuen Cluster anlegen. Paddle zieht die Zahlung ein und stellt die Rechnungen aus; diese Anbindung ist mit echten Zahlungen noch nicht gelaufen. Kosten und Abrechnung.

Ohne PaaSbox weiterbetreibenEinen abgekoppelten Cluster weiterbetreiben: was du ersetzt, ein eigener DNS-Name, Snapshots und Wiederherstellungen von Hand.

SchnellstartDie Schleife, auf der der Ansatz aufbaut: einen Cluster anlegen, nutzen, löschen.