Skip to main content
A template is what a new machine starts from: its operating system, its root disk, and the tools that come preinstalled. When you name no template, a machine starts from agent-browser. The templates, with the operating system, root disk size and tools of each, are listed in Limits. GPU machines start from gpu (GPU templates), and macOS machines from macos (macOS machines).
The free plan creates from only. Any other template is refused with 403 template_not_allowed on the free plan. A machine started from one of your snapshots is not limited by this.

List the templates

This prints one row per template: the version a new machine gets when you name the template without a version. instabox templates --all lists every version, old ones too, with a CREATABLE column. The list is not filtered by your plan. Over the API, GET /v1/templates returns every version. Read these fields on each entry:
  • creatable is true when a create may name this version today.
  • latest is true on the one version per template that a create without a version gets.
  • defaultSpec.rootDiskGiB is the size of the root disk a new machine gets.

Create a machine from a template

Name the template when you create the machine. Over the API the field is templateId on POST /v1/machines.
A new machine gets the version marked latest. To get one exact version, for example to keep a test run reproducible, pin a template version.

Limits

Root disk, OS and tool versions of each template.

Custom images

Start machines from your own Docker or OCI image.