> For the complete documentation index, see [llms.txt](https://docs.portainer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portainer.ai/portainer-command/using-portainer-command/admin/workspaces.md).

# Workspaces

**Workspaces** lists every [AI Workspace](/portainer-command/using-portainer-command/workspace/workspace.md) on the instance, across all users. Each workspace runs as the person who provisioned it and acts with their own Portainer credential.

## View workspaces

The summary cards show the number of **Running workspaces**, how many are **Not connected**, and the **Idle stop** time. Click **Idle stop** to change it in [Settings](/portainer-command/using-portainer-command/admin/settings.md#ai-workspace-details).

The table shows each workspace's **Owner**, **State**, **Where** it runs (namespace and environment), its **Usage** (tokens and cost), when it was **Last used**, and when it **Expires**. Use the search box, the state filter, and the sort menu to narrow the list.

| State             | Meaning                                                                                                                                                   |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Starting          | The pod is being created, or OpenCode is starting inside it.                                                                                              |
| Connected         | The workspace is running and connected to Portainer-Command.                                                                                              |
| Stopped           | The pod is stopped, usually after the idle timeout. Its owner can start it again.                                                                         |
| Crashing          | The pod keeps failing. Check the pod in Portainer.                                                                                                        |
| Image pull failed | The workspace image couldn't be pulled. Check the image in [Settings](/portainer-command/using-portainer-command/admin/settings.md#ai-workspace-details). |
| Expired           | The workspace reached the end of its 90-day lifetime.                                                                                                     |
| Destroyed         | The workspace was destroyed. Its record and transcript remain.                                                                                            |

<figure><img src="https://1938785147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fypmd3gtxKLcOeVHnIvOD%2Fuploads%2FHnEABF3dymjUaaYG6Y9W%2FWorkspace-1.png?alt=media&amp;token=de2aa2df-f158-4533-8689-3c785d947975" alt="Workspaces list"><figcaption></figcaption></figure>

Click a workspace to open it.

## Stop a workspace

Click **Stop** on a workspace, then **Stop workspace**. The pod stops and no longer consumes resources. The workspace keeps its identity, credential, and chat history, and its owner can start it again from their **Workspace** page.

Starting and destroying workspaces are left to their owners. To cut a person's workspace off completely, revoke its connection on [Connections](/portainer-command/using-portainer-command/admin/connections.md), or use [Emergency halt](/portainer-command/using-portainer-command/admin/users.md#emergency-halt) on the user.