---
title: "Шаблони: пісочниці, готові до роботи з першої секунди | Pethost Agent Sandboxes"
description: "Збережіть диск пісочниці як шаблон, разом із пакетами й образами Docker, і запускайте з нього нові пісочниці на будь-якому сервері приблизно за 0,2 с."
---

[Документація Agent Sandboxes](https://pethost.dev/uk/docs/sandboxes/) · Завдання

# Шаблони: пісочниці, готові до роботи з першої секунди

Оновлено 22 листопада 2026 р. · 5 хв читання

Шаблон — це те, з чого стартує пісочниця. Наш, `base`, має інструменти; ваш — це диск пісочниці, збережений як є, зі встановленими вами пакетами, вашим кодом і його образами Docker. Пісочниця з нього запускається приблизно за 0,22 с, і встановлювати вже нічого не треба.

**Коротко**

- **`CreateTemplate`** зберігає диск і налаштування пісочниці як нову версію, `my-app@1`, `my-app@2`, а пісочниця працює далі.
- **SAVING, потім READY** приблизно за 1,5 с для невеликого, і ще приблизно 10 с на кожен GiB його власних даних.
- **`CreateSandbox`** з `"my-app"` стартує з найновішої версії READY, на будь-якому сервері.
- **Лише файли:** шаблон не зберігає ні пам’яті, ні процесів, ні розмов агентів. Він не оплачується; його розмір обмежує ваш тариф.

### Step 1: Підготуйте пісочницю

Створіть пісочницю з `base` і налаштуйте її так, як має бути налаштована кожна нова: склонуйте свій код, установіть його залежності, стягніть образи Docker, які він запускає, прогрійте кеші ([команди й файли](https://pethost.dev/uk/docs/sandboxes/commands-and-files/)). Її налаштування теж важать: шаблон бере життєвий цикл, вихідний трафік, публічні порти й середовище пісочниці такими, як вони є зараз, і пісочниці з нього стартують із ними, якщо під час створення не сказано інакше.

### Step 2: Збережіть її як шаблон

`CreateTemplate` за кілька мілісекунд відповідає новою версією SAVING, щойно зафіксує диск у поточному стані: пісочниця працює далі. Потім сервер стискає версію до того, що вона містить, і завантажує її. Дочекайтеся READY, перш ніж стартувати з цієї версії.

Python

```
import time

from pethost.sandboxes import TemplateState

version = sandboxes.create_template("my-app", sandbox_id=sandbox_id, description="Node 22 and our dependencies")
while version.state == TemplateState.SAVING:
    time.sleep(1)
    version = sandboxes.get_template(f"my-app@{version.version}")
print(version.name, version.version, version.state.name, version.min_size.name, version.size_bytes)
# my-app 1 READY SMALL 25447048
```

TypeScript

```
let version = await sandboxes.createTemplate({
  name: "my-app",
  sandboxId,
  description: "Node 22 and our dependencies",
});
while (version.state === TemplateState.SAVING) {
  await new Promise((resolve) => setTimeout(resolve, 1000));
  version = await sandboxes.getTemplate({ template: `my-app@${version.version}` });
}
console.log(version.name, version.version, version.state, version.minSize, version.sizeBytes);
```

Go

```
version, err := client.CreateTemplate(ctx, &sandboxes.CreateTemplateRequest{
	Name:        "my-app",
	SandboxID:   id,
	Description: "Node 22 and our dependencies",
})
for err == nil && version.State == sandboxes.TemplateStateSaving {
	time.Sleep(time.Second)
	version, err = client.GetTemplate(ctx, &sandboxes.GetTemplateRequest{Template: fmt.Sprintf("my-app@%d", version.Version)})
}
if err != nil {
	log.Fatal(err)
}
fmt.Println(version.Name, version.Version, version.State, version.MinSize, version.SizeBytes)
```

Rust

```
let mut version = sandboxes
    .create_template(CreateTemplateRequest {
        name: "my-app".into(),
        sandbox_id: id.clone(),
        description: "Node 22 and our dependencies".into(),
        ..Default::default()
    })
    .await?;
while matches!(version.state, TemplateState::Saving) {
    tokio::time::sleep(std::time::Duration::from_secs(1)).await;
    let template = format!("my-app@{}", version.version);
    version = sandboxes.get_template(GetTemplateRequest { template, ..Default::default() }).await?;
}
println!("{} {} {:?} {:?} {}", version.name, version.version, version.state, version.min_size, version.size_bytes);
```

CLI

```
$ pethost sandbox template save api-dev my-app --description 'Node 22 and our dependencies'
✓ Saving my-app@2: it is ready once uploaded. See:  pethost sandbox template show my-app@2
my-app@2
$ pethost sandbox template ls my-app
my-app@2   ready   68 MB      55 s ago    Node 22 and our dependencies
my-app@1   ready   24 MB      1 min ago   Node 22 and our dependencies
```

MCP

```
CreateTemplate {"name": "my-app", "sandbox_id": "…", "description": "Node 22 and our dependencies"}
ListTemplates {"name": "my-app"}
```

### Step 3: Запускайте з нього пісочниці

Назвіть шаблон у `CreateSandbox`: `"my-app"` — його найновіша версія READY, `"my-app@2"` — саме ця. Перша пісочниця версії на сервері звантажує її, приблизно 10 с на GiB; сервер її зберігає, і наступні запускаються приблизно за 0,22 с.

Python

```
preview = sandboxes.create_sandbox("my-app")
print(preview.sandbox_id, preview.template)  # 8j37xshusqwdz8cs my-app@1
```

TypeScript

```
const preview = await sandboxes.createSandbox({ template: "my-app" });
console.log(preview.sandboxId, preview.template);
```

Go

```
preview, err := client.CreateSandbox(ctx, &sandboxes.CreateSandboxRequest{Template: "my-app"})
if err != nil {
	log.Fatal(err)
}
fmt.Println(preview.SandboxID, preview.Template)
```

Rust

```
let preview = sandboxes
    .create_sandbox(CreateSandboxRequest { template: "my-app".into(), ..Default::default() })
    .await?;
println!("{} {}", preview.sandbox_id, preview.template);
```

CLI

```
$ pethost sandbox new --template my-app
✓ Made sandbox ofvm8by6buvd4rkd: default, running, from my-app@2, in <1 s
  port 5173: https://5173-ofvm8by6buvd4rkd.sbx1.sandboxes.pethost.network
ofvm8by6buvd4rkd
Next:   pethost sandbox run ofvm8by6buvd4rkd -- <command>   ·   pethost sandbox shell ofvm8by6buvd4rkd
```

MCP

```
CreateSandbox {"template": "my-app"}
```

`template` у відповіді називає точну версію, з якої вона стартувала, як-от `my-app@1`.

## Що зберігає шаблон

- **Зберігає:** кожен файл диска пісочниці, зокрема пакети, ваш код, образи й контейнери Docker; а також налаштування пісочниці, з якими стартують його пісочниці, якщо під час створення не сказано інакше.
- **Не зберігає:** пам’ять і процеси, тож пісочниця із шаблону стартує без нічого запущеного; історію команд і розмови агентів для коду, без яких стартують його пісочниці.
- **Нове в кожній пісочниці:** власні id, ім’я хоста, machine-id і випадковість ядра.

Щоб скопіювати пісочницю з її пам’яттю й процесами, такою, як вона є цієї секунди, зробіть натомість копію: [копіювання](https://pethost.dev/uk/docs/sandboxes/forks/). Шаблон — для багатьох пісочниць упродовж днів; копіювання — для кількох копій зараз.

## Версії й розміри

Кожне збереження під назвою — її наступна версія. `"my-app"` завжди означає найновішу версію READY, а поки нова зберігається — попередню, тож збереження ніколи не ламає ваших створень. Назва зберігає 10 версій; версія FAILED нічого не займає й зникає через добу. Робочий простір зберігає по одній версії за раз, а пісочниця зберігає версію, з якої стартувала, навіть після видалення шаблону.

Версія READY має `min_size`: найменший розмір, чий диск уміщує те, що вона зберегла. Її пісочниці беруть будь-який розмір, починаючи з нього. Створення з меншим розміром відхиляється з назвою розміру, який підходить.

## Де він зберігається і скільки коштує

Версія стискається до того, що містить, архівується, шифрується власним ключем і зберігається в об’єктному сховищі в ЄС, звідки кожен сервер може запускати з неї пісочниці. Рахуються лише її власні байти, а не база під нею. Шаблони не оплачуються: ваш тариф обмежує, скільки разом займають версії робочого простору, 5 GiB на тарифі за 20 $ і 30 GiB на тарифі за 100 $ (`Limits.template_gib`; `Workspace.template_bytes` — скільки вони займають зараз). `DeleteTemplate` видаляє кожну версію назви й одразу звільняє місце; пісочниці, створені з нього, далі працюють, стають на паузу й продовжуються.

## Наш шаблон: base

`base` — це Ubuntu 24.04 з інструментами збирання й git, Python 3, Node.js 22, Docker із Compose, Claude Code, Codex і OpenCode, а також робочий стіл із Google Chrome. Ми перезбираємо його щомісяця, а для виправлення безпеки Chrome, ядра чи пакета — одразу. `Template.base` називає версію, на якій стартують пісочниці шаблону, за хешем її вмісту: збережена вами версія зберігає базу, на якій стартувала її пісочниця, тож ваш шаблон не змінюється без вас.

Збирання з Dockerfile немає: виконайте кроки свого Dockerfile у пісочниці або `docker build` усередині неї й збережіть цю пісочницю.

## Коли не працює

- **`RESOURCE_EXHAUSTED` з `LimitReached`, `template_gib`:** версії робочого простору займають місце, яке дає тариф, або зберігається інша версія. Видаліть старий шаблон або дочекайтеся збереження.
- **`LimitReached`, `template_versions`:** назва має 10 версій. Збережіть під новою назвою або видаліть шаблон і збережіть знову.
- **Версія FAILED:** `failure_message` каже чому, як-от для версії, чиї власні байти перевищили вільне місце. Звільніть місце, потім збережіть знову.
- **`INVALID_ARGUMENT` із назвою розміру:** розмір менший за `min_size` версії. Попросіть цей розмір або більший.
- **Перша пісочниця з нової версії повільна:** її сервер звантажував версію, приблизно 10 с на GiB. Наступні там запускаються приблизно за 0,22 с.

## Запитання

### Як створити власний шаблон пісочниці?

Налаштуйте пісочницю так, як хочете бачити нові, потім викличте `CreateTemplate` з назвою та її id. Запускайте нові пісочниці з цією назвою.

### Чи зберігає шаблон запущені процеси?

Ні: лише файли й налаштування. Щоб скопіювати пісочницю, що працює, з її пам’яттю й процесами, зробіть її копію.

### Чи оплачуються шаблони?

Ні. Ваш тариф обмежує, скільки GiB займають шаблони робочого простору в об’єктному сховищі.

### Чи можна зібрати шаблон із Dockerfile?

Не напряму: виконайте кроки Dockerfile або `docker build` у пісочниці, потім збережіть пісочницю як шаблон.

### Чи зберігаються образи Docker у шаблоні?

Так. Образи й контейнери Docker лежать на диску пісочниці, який зберігає шаблон.

[НазадКерування комп’ютером: Chrome на робочому столі в пісочниці](https://pethost.dev/uk/docs/sandboxes/computer-use/) [ДаліСекрети й вихідний трафік: ключі, яких пісочниця не тримає](https://pethost.dev/uk/docs/sandboxes/secrets-and-egress/)

## Спробуйте Pethost Agent Sandboxes

Пробний період на 7 днів із використанням на 1 $ і 4 vCPU, потрібна картка. Далі — тариф від 20 $ на місяць, який включає стільки ж використання.

[Почати пробний період](https://console.pethost.dev/)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблони](https://pethost.dev/uk/templates/)
- [Про нас](https://pethost.dev/about/)
- [Документація](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/uk/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Плагін](https://github.com/pethost-dev/plugin)
- [Умови](https://pethost.dev/terms/)
- [Конфіденційність](https://pethost.dev/privacy/)
- [Повернення коштів](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Бази даних

- [Postgres](https://pethost.dev/uk/postgres/)
- [Valkey](https://pethost.dev/uk/valkey/)

Agent Sandboxes

- [Пісочниці](https://pethost.dev/uk/sandboxes/)
- [Тарифи](https://pethost.dev/uk/sandboxes/#pricing)
- [Документація](https://pethost.dev/uk/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Порівняння

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/uk/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/uk/blog/coolify-cloud-vs-dokploy-cloud/)
- [Ціни Railway vs Render vs Fly.io](https://pethost.dev/uk/blog/railway-vs-render-vs-fly-io-pricing/)
- [Керований хостинг Docker Compose](https://pethost.dev/uk/blog/managed-docker-compose-hosting/)

Альтернативи

- [Альтернативи Railway](https://pethost.dev/uk/blog/railway-alternatives/)
- [Альтернативи Heroku](https://pethost.dev/uk/blog/heroku-alternatives/)
- [Альтернативи Dokploy](https://pethost.dev/uk/blog/dokploy-alternatives/)
- [Альтернативи Coolify](https://pethost.dev/uk/blog/coolify-alternatives/)
- [Альтернативи Render](https://pethost.dev/uk/blog/render-alternatives/)
- [Альтернативи Sliplane](https://pethost.dev/uk/blog/sliplane-alternatives/)
