Overview
Build custom agent environments from any Docker image.Container templates = Custom Docker environments
Saved templates (
instance.snapshot()) = Workspace snapshotsCreate a Template
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable template name |
image | string | Yes | Base Docker image (e.g., python:3.11-slim) |
registryType | string | Yes | Registry type: dockerhub, private, or gcr |
description | string | No | Template description |
registryAuth | object | No | Authentication for private registries |
Registry Types
dockerhub- Public Docker Hubprivate- Private registriesgcr- Google Container Registry
Build Status
building→readyorfailed
Wait for Build
List & Get Templates
Use Template
Private Registry
Quick Examples
Saved Templates (Snapshots)
Saved templates are workspace snapshots created withinstance.snapshot(). They are managed via client.savedTemplates:
Template vs Saved Template
| Feature | Container Template | Saved Template |
|---|---|---|
| Method | client.templates.create() | instance.snapshot() |
| Creates | Custom Docker environment | Workspace snapshot |
| Build time | 2-5 minutes | Instant |
| Use case | Base environments | Reuse workspaces |
| Clone with | containerTemplateId in create | createFromSavedTemplate() |

