Workspace Details Page
The Workspace Details page shows a single workspace and lets you edit it. It reuses the same sectioned form as the create page, prefilled with the workspace’s current configuration. Status, messages, and other live fields update in real time over a WebSocket subscription.
Header
Section titled “Header”The header shows the workspace name, a status badge, and a badge for the host it runs on (click it to open the host). It also exposes the workspace actions (Logs, Attach, Exec, Start/Stop, Redeploy, Snapshot, Clone) and the created/updated timestamps. Which actions appear depends on the workspace status, the host status, and your permissions.
Messages
Section titled “Messages”When the agent reports an error or warning for the workspace (for example a failed deployment), a Messages section appears at the top with the details.
Editing
Section titled “Editing”The configuration form mirrors the create form: workspace settings, host, image, configuration (CPU, memory, shared memory, GPUs, advanced runtime options), startup command, external URLs, environment variables, ports, volumes, and networks. Save applies the changes. The agent reconciles the running container to match. The save button is enabled only when you have changed something and you have modify permission.
Some edits can be applied to the running container, but many settings can only be set when a container is created, so changing them redeploys the workspace by replacing its container. This discards anything written inside the container itself. Attached volumes and bind mounts (and their data) are preserved. Rename and network changes are applied in place, while changes such as the image, resource limits, environment variables, ports, and attached storage recreate the container. For the full list of what does and does not recreate, see Applying changes to a workspace.
Permissions
Section titled “Permissions”Grant or revoke per-user access to the workspace. Each grant is a combination of view, modify, and delete. View covers logs and opening the workspace. Attach and Exec need modify, and a view grant transitively reveals the workspace’s image, host, volumes, and networks. See Permissions and access control.
Delete
Section titled “Delete”A confirmation form removes the workspace. You must type the workspace name to confirm. Delete is only available to users with delete permission.
Related Pages
Section titled “Related Pages”- Workspaces Workspace listing
- Workspace Logs Stream container logs
- Workspace Attach Attach to the main process
- Workspace Exec Run a command in the container