Skip to main content
The delete command removes a deployment immediately, rather than waiting for it to expire naturally.
This command requires authentication. Run sher login first.

​
Usage

sher delete <id>
Alias: 
sher rm <id>

​
Arguments

​
id
string
required
The deployment ID to delete. This is the subdomain part of your sher.sh URL.For example, if your deployment URL is https://abc123.sher.sh, the ID is abc123.

​
Examples

​
Delete by ID

sher delete abc123

  Deleted abc123

​
Get ID from list command

First, list your deployments to find the ID: 
sher list

  sher — your deployments

  https://abc123.sher.sh  22h 15m left
  https://def456.sher.sh  5h 42m left  🔒
Then delete a specific deployment: 
sher delete def456

  Deleted def456

​
Error Handling

​
Missing deployment ID

If you don’t provide a deployment ID: 
sher delete

  Usage: sher delete <id>

​
Not logged in

If you’re not authenticated: 
sher delete abc123

  Login required. Run `sher login` first.

​
Deployment not found

If the deployment doesn’t exist or doesn’t belong to you: 
sher delete xyz999

  Delete failed (404)
or 
  Deployment not found
Deleting a deployment is permanent and cannot be undone. The link will immediately stop working.

​
Use Cases

​
Remove outdated previews

Delete old deployments that are no longer needed: 
sher list
sher delete abc123

​
Quickly iterate

Delete and recreate a deployment when testing: 
sher delete abc123
sher link

​
Manage rate limits

Free up deployment slots if you’ve hit the rate limit and need to create new links: 
sher list
sher delete old-deployment-id
sher link

Build docs developers (and LLMs) love

Get started for freeTalk to us