Unsere: base
Jede Sandbox startet aus einer Vorlage. Unsere ist base: Ubuntu 24.04 mit build-essential, git, curl, wget, ripgrep und jq; Python 3 mit pip und venv; Node.js 22; Claude Code, Codex und OpenCode mit ihren SDKs; Docker mit Compose und Buildx; und ein Desktop mit 1280×800 und Google Chrome. Du arbeitest als user, mit sudo und ohne Passwort. Ihr Root-Dateisystem ist schreibgeschützt und wird direkt von der Disk des Servers gelesen, also kostet, was eine Sandbox nicht ausführt, sie keinen RAM, und weder der Desktop noch Docker startet, bis etwas danach fragt.
Jede Version von base ist nach dem sha256 dessen benannt, was sie enthält: das Betriebssystem, seine Pakete und der Gast-Kernel. Wir bauen jeden Monat eine neue und sofort bei einem Sicherheitsfix für Chrome, den Kernel oder die Pakete. Neue Sandboxes starten mit der neuesten; eine Sandbox und eine aus ihr gespeicherte Vorlage behalten die Basis, mit der die Sandbox gestartet ist.
Eigene Vorlagen, aus einer Sandbox gespeichert
Eine eigene Vorlage ist die Disk einer Sandbox, über unserer Basis gespeichert. Richte die Sandbox ein, von Hand oder durch einen Agenten, dann speichert create_template ihre Disk als nächste Version eines Namens: my-app@1, dann my-app@2. Sie speichert nur Dateien: keinen RAM, keine laufenden Prozesse und weder den Befehlsverlauf der Sandbox noch die Unterhaltungen ihrer Agenten, ohne die neue Sandboxes starten.
Der Aufruf antwortet in 28 bis 49 ms mit der Version im Zustand SAVING. Eine laufende Sandbox läuft weiter, für einige Millisekunden angehalten, während ihre Disk übernommen wird. Dann prüft der Server das Dateisystem und verkleinert es auf das, was es enthält, in einer eigenen Helfer-VM, und lädt nur die Chunks, die deine sind, in den Objektspeicher hoch, komprimiert und verschlüsselt mit einem Schlüssel nur für diese Version. Die Version einer kleinen Sandbox ist 0,9 bis 1,5 s nach dem Aufruf READY; allgemein dauert es etwa 5 s plus 10 s pro GiB deiner eigenen Daten. Eine Version im Zustand READY nennt ihre min_size, die kleinste Größe, deren Disk fasst, was sie gespeichert hat.
Sandboxes daraus starten
Nenn die Vorlage, wenn du eine Sandbox erstellst: my-app nimmt ihre neueste Version im Zustand READY, my-app@3 genau diese. Jeder Server startet Sandboxes aus jeder Version. Das Panel fragt zuerst die Server, die die Version schon haben, und dort dauert das Erstellen 218 bis 225 ms. Ein Server, dem sie fehlt, holt sie einmal, etwa 10 s pro GiB, das die Version enthält, und behält sie für das nächste Mal. Eine Sandbox aus einer Vorlage nimmt jede Größe ab der min_size der Version.
Die Images von Docker liegen auf der Disk der Sandbox, also nimmt eine Vorlage sie mit: Eine daraus erstellte Sandbox führt docker run mit einem Image aus, das sie nie gepullt hat. (Die Zeiten hier wurden über ein Panel 16 ms vom Server entfernt gemessen.)
import time
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # liest PETHOST_TOKEN
sandbox = sandboxes.create_sandbox() # aus base
sandboxes.run_command(
sandbox.sandbox_id,
command="python3 -m venv ~/venv && ~/venv/bin/pip install pandas && docker pull postgres:18",
)
version = sandboxes.create_template("my-app", sandbox_id=sandbox.sandbox_id)
name = f"my-app@{version.version}"
while sandboxes.get_template(name).state.name == "SAVING":
time.sleep(1)
copy = sandboxes.create_sandbox(name) # pandas und das Image von postgres sind da
print(sandboxes.run_command(copy.sandbox_id, command="docker images postgres").stdout)pethost sandbox template save api-dev my-app # ihre Disk, als nächste Version von my-app
pethost sandbox template show my-app # SAVING, dann READY
pethost sandbox new --template my-app # eine neue Sandbox aus der neuesten VersionVersionen, Platz und Preis
Ein Name hat bis zu 10 Versionen. Ein Workspace speichert eine Version nach der anderen, und seine Versionen passen zusammen in den Platz für Vorlagen seines Tarifs, gezählt als das, was sie komprimiert im Objektspeicher belegen:
| Tarif | Platz für Vorlagen |
|---|---|
| 20 $ im Monat | 5 GiB |
| 100 $ im Monat | 30 GiB |
| 500 $ im Monat | 175 GiB |
| 2.000 $ im Monat | 800 GiB |
Vorlagen kosten über diesen Platz hinaus nichts. Das Löschen einer Vorlage, aller Versionen ihres Namens, gibt ihren Platz sofort frei, und die daraus erstellten Sandboxes laufen, pausieren, stoppen und starten weiter: Der Objektspeicher behält eine Version, bis die letzte von ihnen gelöscht ist.
Was Vorlagen noch nicht können
Einen Build aus einem Dockerfile gibt es noch nicht: Installier in einer Sandbox und speichere sie, wie oben. Eine Vorlage nimmt Dateien mit, nie laufende Prozesse. Um eine Sandbox mit RAM und Prozessen zu kopieren, mit laufendem Dev-Server oder einem Agenten mitten in einer Aufgabe, forke sie. Jede Sandbox, aus einer Vorlage oder nicht, ist eine eigene Firecracker-MicroVM mit eigenem Kernel. Die Anleitung zu Vorlagen hat jeden Aufruf und jedes Feld.
Im Vergleich
Am 21. November 2026 baute E2B Vorlagen mit seinem Vorlagen-Builder, und Daytona erstellte Snapshots aus einem Image oder einem Dockerfile, was Pethost noch nicht kann. boat.dev speichert Snapshots und berechnet 0,056 $ pro Snapshot und Tag über die im Tarif enthaltenen hinaus. Eine Vorlage bei Pethost kostet im Platz deines Tarifs nichts.