Skip to content
Trailer.devDocumentation

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

Workspaces Page

The Workspaces table showing several workspaces with status, resources, image, ports, and the per-row actions menu.

The Workspaces page lists every workspace you can access. A workspace is a running container deployed from an image onto a host. The page is a searchable, sortable table with per-row and batch actions. Status updates arrive in real time over a WebSocket subscription, so a workspace that starts, stops, or errors updates without a manual refresh.

Table columns

Section titled “Table columns”
  • Name the workspace name and icon. Links to the workspace details page.
  • Status current lifecycle state (see below). The status cell also exposes the row actions.
  • Resources live CPU and memory usage for the workspace, shown as percent (or cores used) and used-over-total with bars. Hovering opens a popover with CPU, memory, and (if the workspace has GPUs) GPU utilization charts, plus the configured CPU/memory limits.
  • Image the image the workspace was deployed from.
  • Ports published port mappings.
  • Volumes attached volumes and bind mounts.
  • Networks attached networks.
  • URLs external URLs routed to the workspace.
  • Actions the per-row action menu.

Sorting is available on Name, Status, and Image. Host sorting applies on the Workspace Templates page, where the Host column is shown.

The search bar matches the workspace’s name and description, plus the name, description, and configuration of its image, so you can also find workspaces by what their image contains. Matching is partial and not case sensitive.

Workspace status

Section titled “Workspace status”

A workspace reports one of these states:

  • Build pending and Building - the workspace’s image is queued for or undergoing a build.
  • Deployment pending - workspace queued for deployment.
  • Deploying - the agent is creating the workspace.
  • Starting - the workspace is starting.
  • Running - the workspace is up.
  • Stopping - stopping was requested for the workspace.
  • Stopped - the workspace is not running.
  • Snapshotting - the workspace is being captured into a new image.
  • Error - deployment or reconciliation failed. The error message is shown on the details page or by hovering the status badge.

Actions

Section titled “Actions”

Open the action menu from the Status cell or the Actions column. Which actions appear depends on the workspace status, the host status, and your permissions:

  • Logs to stream the container logs.
  • Attach to open an interactive terminal attached to the workspace’s main process.
  • Exec to run a command inside the running workspace.
  • Start / Stop to enable or disable the workspace.
  • Redeploy to re-run deployment.
  • Snapshot to capture the running workspace into a new image (only when the host supports snapshotting).
  • Clone to open the create form prefilled from this workspace.
  • Delete to remove the workspace.

Attach, Exec, Logs, Start, Stop, and Snapshot are hidden when the host is offline. Attach and Exec are available unless the workspace is stopped, stopping, or errored, and they require modify permission and an online host. Select multiple rows to apply Start, Stop, Redeploy, or Delete as a batch.

Creating a workspace

Section titled “Creating a workspace”

Use the New workspace button to open the create form. See Create Workspace.

Section titled “Related Pages”