Skip to main content
A template is a reusable machine environment. You define a builder, run a build, and then create machines from the resulting template ref.

Build Flow

  1. Select a base image, existing template, or Dockerfile.
  2. Add setup steps such as package installs, file copies, repository clones, and build commands.
  3. Configure runtime defaults such as environment variables, user, workdir, start command, and readiness probe.
  4. Build the template. Nullspace prepares the environment and stores a snapshot.
  5. Create machines with Machine.create(template="name:tag").
See the API reference for the full template build request schema. Build envs only apply while the template is being built. Runtime envs are persisted into machines launched from the template.

Template Refs

Template refs can be names, tags, aliases, canonical refs, or IDs depending on the operation. For launch paths, prefer stable refs such as my-template:stable.