Stop Workspaces

⚠️ Gitpod Self-hosted is no longer supported

The last update of Gitpod Self-hosted product was November 2022. Users can still request our free community license however there will be no support or updates to the product. If you are interested in an isolated, private installation of Gitpod, take a look at 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?