Наш шаблон: 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 пока нет: установите все в песочнице и сохраните ее, как выше. Шаблон переносит файлы, но никогда не работающие процессы. Чтобы скопировать песочницу вместе с памятью и процессами — с работающим dev-сервером или агентом на середине задачи, — сделайте форк. Каждая песочница, из шаблона или нет, — отдельная микроВМ Firecracker с собственным ядром. Все вызовы и поля описаны в руководстве по шаблонам.
Сравнение с другими
На 21 ноября 2026 года E2B собирал шаблоны своим сборщиком шаблонов, а Daytona делал снимки из образа или Dockerfile, чего Pethost пока не умеет. boat.dev сохраняет снимки и берет 0,056 $ в день за снимок сверх включенных в тариф. Шаблон Pethost ничего не стоит в пределах места по вашему тарифу.