Stop Workspaces

⚠️ Gitpod Self-hosted has been replaced with Gitpod Dedicated, a self-hosted, single-tenant managed service that runs in your private cloud account but is managed by us.
Try out Gitpod Dedicated.

Sometimes it becomes necessary to stop Gitpod workspaces (in a <namespace>). Usually this needs to be done when updating Gitpod. Please see the update guide for more information.

This can be done with kubectl, and when done so, the IDE is closed, data in /workspace is backed up, and then the pod finally terminates.

A Single Workspace

language icon language: 
bash
$ kubectl delete pods <workspace-or-headless-pod-name> -n <namespace>

All Workspaces

Caution: This will delete all actively running workspaces.

Can be done prior to outage windows, or for troubleshooting.

language icon language: 
bash
$ kubectl delete pods -l component=workspace -n <namespace>

Was this helpful?