Stop, archive, and clean up
EasyEnv has no destructive Delete button. To wind a workspace down you Stop it (frees compute, keeps state) and Archive it (hides it, reversible). Here is what each does and when to reach for it.
Stop vs archive#
EasyEnv intentionally does not expose a destructive "Delete" button. Workspaces have two endings: Stop (releases compute now) and Archive (hides the workspace from the main list). Both are reversible - Stop via Clone, Archive via Unarchive.
| Field | Type | Description |
|---|---|---|
| Stop | reversible | Ends running processes and releases compute. The workspace card flips to Stopped and shows a Clone + Audit pair so you can spin up a copy or inspect the recording. Available on the card as a Stop icon-button next to Console. |
| Archive | reversible | Soft-deletes the workspace: it disappears from the main Workspace List and shows up under Workspaces -> Archived in the sidebar. An Unarchive button on the archived card brings it back. Only available when the workspace is not Running or Starting up. |
| TTL termination | automatic | When the configured duration runs out, EasyEnv stops the workspace for you. The card flips to Terminated with a duration badge ("1h 0m") next to the status pill. |
Stop a workspace#
Each Running workspace card has a Stop icon-button on the right of the action row, next to Console. Click it and a small confirmation dialog appears - one line of warning, a Go back button, and a primary Stop workspace button. There is no name-typing ceremony.
Running processes will end. Unsaved work may be lost.
Archive a workspace#
Archive lives in the kebab (three-dot) menu on the card and is only enabled when the workspace is not currently Running or Starting up. Archiving moves the workspace out of the main list and into Workspaces -> Archived in the sidebar, where members can still find it later. Stacks, recipes, audit data, and membership are all preserved.
- Details
- Clone
- Save as template
- Archive
Unarchive (restore)#
Open Workspaces -> Archived in the sidebar to see every archived workspace. The action row on each card has a single Unarchive button - click it to move the workspace back into the main list.
Automatic termination (Duration)#
Every workspace has a duration set at create time (the Duration field in step 3 of the wizard). When the timer runs out, EasyEnv stops the workspace and the card status flips to Terminated, with the actual run duration shown as a small badge next to the status pill (e.g. Terminated | 1h 0m). The card then offers Clone + Audit in the action row.
From the CLI#
# Stop a running workspace (releases compute)
easyenv workspace stop <workspace-id>
# Archive a stopped/terminated workspace (hides from the list)
easyenv workspace archive <workspace-id>
# Bring it back
easyenv workspace unarchive <workspace-id>