Skip to content
Trailer.devDocumentation

Search is only available in production builds. Try building and previewing the site to test it out locally.

Image Templates Page

The Image Templates table with the host column and the Use template and New template actions.

Image templates are reusable image configurations. A template is an image record flagged as a template; it carries a full image configuration but is not itself built into a workspace base. Use a template to seed a new image with its settings already filled in.

This page uses the same table as the Images page, with two differences: the status column is hidden (templates are not built), and a build-host column is shown. The search bar matches the same fields as on the Images page: the template’s name, description, and configuration (including its services).

Table columns

Section titled “Table columns”
  • Name: the template name and its creator.
  • Host: the build host recorded on the template.
  • Image name: the Docker reference, shown as repository:tag.
  • Enabled: whether the template is enabled.
  • Pulled image: marks templates based on a pulled image.
  • Last update: when the template last changed.

Actions

Section titled “Actions”
  • Use template: opens the create-image form pre-filled from the template.
  • Enable / Disable: toggles the template.
  • Delete: removes the template.

Use New template to create a template from scratch. The create form is the same as for images; choosing Save as template stores the configuration as a template instead of a buildable image.

Permissions

Section titled “Permissions”

Template access follows the same view, modify, and delete model as images. Admins and the creator have full access.

Section titled “Related Pages”