The workspace detail page in Codespace gives you a unified view of a workspace and its resources.
Accessing a workspace
- Go to your instance detail page
- Click the Workspaces tab
- Click a workspace to open its detail page
Workspace detail page
The detail page shows:
- Name — displayed as
owner/workspace-name
- Status badge — current state
- Last used — relative timestamp
- Template — which template it was created from
Actions
Start, stop, and restart
Use the action buttons in the header:
- Start — boot the workspace (when stopped)
- Stop — shut down compute but keep storage (when running)
- Restart — stop and start in sequence (when running)
Update template
If the workspace’s template has been updated, an Update button appears. Clicking it rebuilds the workspace with the latest template version.
Duplicate
Create a copy of the workspace:
- Click the overflow menu (three dots)
- Select Duplicate
- Enter a name for the new workspace
- Click Duplicate
The new workspace uses the same template and configuration.
Delete
Permanently remove a workspace:
- Click the overflow menu
- Select Delete
- Type the workspace name to confirm
- Click Delete Workspace
Deleting a workspace destroys all its data, including persistent volumes. This cannot be undone.
Favorite
Click the star icon to mark a workspace as a favorite for quick access.
Resources
The resources section shows the Kubernetes resources backing the workspace:
- Pod — the running container
- Agents — processes providing access to the workspace
- Agent name, status, OS, architecture, and version
- Available apps (terminal, code-server, custom apps)
Click an app link to open it directly — for example, a web terminal or VS Code in the browser.
Quick links
- Open Terminal — launch a terminal session in the workspace
- Workspace Settings — open Coder’s workspace settings page
- Schedule Settings — configure auto-start/stop schedules
