Skip to content
Trailer.devDocumentation

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

Images Page

The Images table showing the name, status, image name, enabled and pulled-image columns, with the per-row action buttons and the New image button.

The Images page lists the container images that workspaces are built from. Each row is a Trailer image record. From here you build, enable, clone, and delete images, or jump straight to creating a workspace from a finished image.

The same table component powers the Image Templates page; templates are just image records flagged as templates.

Table columns

Section titled “Table columns”
  • Name: the Trailer name of the image, plus its creator.
  • Status: build state. One of Build pending, Building, Build finished, Build cancelled, Snapshotting, or Error. The status cell also exposes the row actions.
  • Image name: the resulting Docker image reference, shown as repository:tag.
  • Enabled: only enabled images can be used to create workspaces.
  • Pulled image: marks images that were pulled from a registry rather than built locally.
  • Last update: when the record last changed.

The search bar matches the image’s name, description, and configuration (including its services), with partial, case insensitive matching. You can sort by most columns. Status updates stream in live while a build runs.

Row actions

Section titled “Row actions”

Available actions depend on the image status and your permissions:

  • Create workspace: shown for non-template images whose status is Build finished. Opens the create-workspace form with this image pre-selected.
  • Build: queues the image for building by setting its status to Build pending. Hidden while a build is pending or running.
  • Cancel build: shown while the status is Build pending or Building.
  • Enable / Disable: toggles whether the image can back new workspaces.
  • Clone: opens the create-image form pre-filled from this image.
  • Delete: removes the image record.

Build, enable, disable, and cancel run immediately. Delete and the batch operations go through a confirmation modal. Select multiple rows to run an action as a batch.

Permissions

Section titled “Permissions”

What you can do depends on your access to the image:

  • View: see the image in the list.
  • Modify: build, enable, disable, and cancel builds.
  • Delete: remove the image.

Admins and the image creator have full access. Other users act within the per-image permissions granted to them.

Section titled “Related Pages”