Наш шаблон: base
Кожна пісочниця стартує із шаблону. Наш — base: Ubuntu 24.04 з build-essential, git, curl, wget, ripgrep і jq; Python 3 з pip і venv; Node.js 22; Claude Code, Codex і OpenCode з їхніми SDK; Docker з Compose і Buildx; і робочий стіл 1280×800 із Google Chrome. Ви працюєте як user, із sudo без пароля. Його коренева файлова система доступна лише для читання й читається просто з диска сервера, тож те, чого пісочниця не запускає, не коштує їй пам’яті, а ні робочий стіл, ні Docker не запускаються, доки щось їх не попросить.
Кожна версія base названа за sha256 свого вмісту: операційної системи, її пакетів і гостьового ядра. Ми збираємо нову щомісяця, а для виправлення безпеки Chrome, ядра чи пакетів — одразу. Нові пісочниці стартують із найновішої; пісочниця й шаблон, збережений із неї, зберігають базу, з якої пісочниця стартувала.
Власні шаблони, збережені з пісочниці
Власний шаблон — це диск пісочниці, збережений поверх нашої бази. Налаштуйте пісочницю вручну чи руками агента, і create_template збереже її диск як наступну версію назви: my-app@1, потім my-app@2. Зберігаються лише файли: ні пам’яті, ні запущених процесів, ні історії команд пісочниці чи розмов агентів — нові пісочниці починають без них.
Виклик відповідає за 28–49 ms із версією в стані SAVING. Пісочниця, що працює, працює далі, зупиняючись на кілька мілісекунд, поки знімається її диск. Потім сервер перевіряє файлову систему й зменшує її до розміру вмісту в окремій допоміжній ВМ і завантажує в об’єктне сховище лише ваші власні фрагменти, стиснені й зашифровані ключем лише для цієї версії. Версія невеликої пісочниці стає READY через 0,9–1,5 с після виклику; загалом це займає близько 5 с плюс 10 с на кожен GiB ваших власних даних. Версія в стані READY вказує свій min_size, найменший розмір, чий диск уміщує те, що вона зберегла.
Запуск пісочниць із шаблону
Назвіть шаблон під час створення пісочниці: my-app бере його найновішу версію в стані READY, my-app@3 — саме цю. Будь-який сервер запускає пісочниці з будь-якої версії. Панель спершу звертається до серверів, які вже мають цю версію, і там створення займає 218–225 ms. Сервер, у якого її немає, стягує її один раз, приблизно 10 с на кожен GiB версії, і зберігає для наступних. Пісочниця із шаблону може мати будь-який розмір, починаючи з min_size версії.
Образи Docker лежать на диску пісочниці, тож шаблон їх переносить: пісочниця, створена з нього, виконує docker run з образом, якого ніколи не стягувала. (Час тут виміряно через панель на відстані 16 ms від сервера.)
import time
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # читає PETHOST_TOKEN
sandbox = sandboxes.create_sandbox() # з 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 і образ postgres уже на місці
print(sandboxes.run_command(copy.sandbox_id, command="docker images postgres").stdout)pethost sandbox template save api-dev my-app # її диск як наступна версія my-app
pethost sandbox template show my-app # SAVING, потім READY
pethost sandbox new --template my-app # нова пісочниця з найновішої версіїВерсії, місце й ціна
Назва вміщує до 10 версій. Робочий простір зберігає одну версію за раз, а всі його версії разом мають уміститися в місце для шаблонів його тарифу, яке рахується за тим, скільки вони займають в об’єктному сховищі, стиснені:
| Тариф | Місце для шаблонів |
|---|---|
| 20 $ на місяць | 5 GiB |
| 100 $ на місяць | 30 GiB |
| 500 $ на місяць | 175 GiB |
| 2 000 $ на місяць | 800 GiB |
Шаблони нічого не коштують понад це місце. Видалення шаблону, тобто всіх версій його назви, одразу звільняє місце, а пісочниці, створені з нього, далі працюють, стають на паузу, зупиняються й продовжуються: об’єктне сховище зберігає версію, доки не видалено останню з них.
Чого шаблони поки не вміють
Збирання з Dockerfile поки немає: встановіть усе в пісочниці й збережіть її, як описано вище. Шаблон переносить файли, але ніколи не запущені процеси. Щоб скопіювати пісочницю з пам’яттю й процесами, із запущеним сервером розробки чи агентом на півдорозі до розв’язання завдання, скопіюйте її. Кожна пісочниця, із шаблону чи ні, — окрема microVM Firecracker із власним ядром. Посібник із шаблонів описує кожен виклик і поле.
Порівняння з іншими
21 листопада 2026 року E2B збирав шаблони своїм конструктором шаблонів, а Daytona створювала знімки з образу або Dockerfile, чого Pethost поки не вміє. boat.dev зберігає знімки й бере 0,056 $ за знімок на день понад ті, що включені в тариф. Шаблон Pethost нічого не коштує в межах місця вашого тарифу.