Nasz: base
Każdy sandbox startuje z szablonu. Nasz to base: Ubuntu 24.04 z build-essential, git, curl, wget, ripgrep i jq; Python 3 z pip i venv; Node.js 22; Claude Code, Codex i OpenCode z ich SDK; Docker z Compose i Buildx; i pulpit 1280×800 z Google Chrome. Pracujesz jako user, z sudo bez hasła. Jego główny system plików jest tylko do odczytu i czytany prosto z dysku serwera, więc to, czego sandbox nie uruchamia, nie zajmuje mu pamięci, a ani pulpit, ani Docker nie startują, dopóki coś ich nie potrzebuje.
Każda wersja base jest nazwana sha256 tego, co zawiera: systemu operacyjnego, jego pakietów i jądra gościa. Nową budujemy co miesiąc, a od razu przy poprawce bezpieczeństwa Chrome, jądra albo pakietów. Nowe sandboxy startują z najnowszej; sandbox i zapisany z niego szablon zostają przy bazie, z której sandbox wystartował.
Własne szablony, zapisane z sandboxa
Własny szablon to dysk sandboxa zapisany na naszej bazie. Przygotuj sandbox, ręcznie albo rękami agenta, a potem create_template zapisze jego dysk jako następną wersję nazwy: my-app@1, potem my-app@2. Zapisuje tylko pliki: bez pamięci, bez działających procesów i bez historii poleceń sandboxa ani rozmów agentów, bez których nowe sandboxy startują.
Wywołanie odpowiada w 28–49 ms wersją w stanie SAVING. Działający sandbox działa dalej, z przerwą na kilka milisekund, gdy zapisujemy jego dysk. Potem serwer sprawdza system plików i zmniejsza go do tego, co zawiera, w osobnej pomocniczej maszynie wirtualnej, i wysyła do magazynu obiektów tylko twoje fragmenty, skompresowane i zaszyfrowane kluczem tylko dla tej wersji. Wersja małego sandboxa jest READY 0,9–1,5 s po wywołaniu; w ogólności trwa to ok. 5 s plus 10 s na każdy GiB twoich własnych danych. Wersja READY podaje swój min_size, najmniejszy rozmiar, którego dysk zmieści to, co zapisała.
Uruchamianie z niego sandboxów
Podaj szablon przy tworzeniu sandboxa: my-app bierze jego najnowszą wersję READY, my-app@3 dokładnie tę. Każdy serwer uruchamia sandboxy z każdej wersji. Panel najpierw pyta serwery, które już mają tę wersję, i tam utworzenie trwa 218–225 ms. Serwer, który jej nie ma, pobiera ją raz, ok. 10 s na każdy GiB wersji, i trzyma ją na następny raz. Sandbox z szablonu może mieć dowolny rozmiar od min_size wersji w górę.
Obrazy Dockera leżą na dysku sandboxa, więc szablon je przenosi: sandbox z niego uruchamia docker run na obrazie, którego nigdy nie pobierał. (Czasy zmierzono przez panel oddalony o 16 ms od serwera).
import time
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # czyta PETHOST_TOKEN
sandbox = sandboxes.create_sandbox() # z 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 i obraz postgres są na miejscu
print(sandboxes.run_command(copy.sandbox_id, command="docker images postgres").stdout)pethost sandbox template save api-dev my-app # jego dysk jako następna wersja my-app
pethost sandbox template show my-app # SAVING, potem READY
pethost sandbox new --template my-app # nowy sandbox z najnowszej wersjiWersje, miejsce i cena
Nazwa mieści do 10 wersji. Przestrzeń robocza zapisuje jedną wersję naraz, a wszystkie jej wersje razem mieszczą się w miejscu na szablony z jej planu, liczonym jako to, co zajmują w magazynie obiektów, po kompresji:
| Plan | Miejsce na szablony |
|---|---|
| 20 $ miesięcznie | 5 GiB |
| 100 $ miesięcznie | 30 GiB |
| 500 $ miesięcznie | 175 GiB |
| 2000 $ miesięcznie | 800 GiB |
Szablony nic nie kosztują poza tym miejscem. Usunięcie szablonu, czyli każdej wersji jego nazwy, od razu zwalnia jego miejsce, a sandboxy z niego utworzone dalej działają, wstrzymują się, zatrzymują i wznawiają: magazyn obiektów trzyma wersję, dopóki nie zostanie usunięty ostatni z nich.
Czego szablony jeszcze nie robią
Nie ma jeszcze budowania z Dockerfile: zainstaluj wszystko w sandboxie i zapisz go, jak wyżej. Szablon przenosi pliki, nigdy działające procesy. Żeby skopiować sandbox z pamięcią i procesami, z działającym serwerem deweloperskim albo agentem w połowie zadania, zrób jego fork. Każdy sandbox, z szablonu czy nie, to osobna microVM Firecracker z własnym jądrem. Przewodnik po szablonach ma każde wywołanie i pole.
Jak to wypada na tle innych
21 listopada 2026 E2B budowało szablony swoim kreatorem szablonów, a Daytona robiła snapshoty z obrazu albo z Dockerfile, czego Pethost jeszcze nie robi. boat.dev zapisuje snapshoty i liczy 0,056 $ za snapshot dziennie ponad te zawarte w planie. Szablon w Pethost nic nie kosztuje w ramach miejsca w twoim planie.