---
title: "Uninstall"
description: "Remove the Worker, the container apps, and the images of an install."
---

> Documentation Index
> Fetch the complete documentation index at: https://cf-orbs-site.mdick85.workers.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Uninstall

## Dry run

```sh
npx cf-orbs uninstall
```

Without `--yes`, the command lists what it would delete and deletes nothing:

- The Worker.
- The container apps (`<name>-orbsession` and `<name>-providerhost`).
- The container image tags of this install.

## Delete

```sh
npx cf-orbs uninstall --yes
```

The command deletes the Worker, then each container app, then each image. If a delete fails, it reports the error. Run `cf-orbs uninstall --yes` again, and it skips what's already gone.

Local files in `.cf-orbs/` are kept. Remove the project directory to delete them.

## Snapshot data stays

The container API can't delete snapshots, so Cloudflare keeps snapshot data for up to 30 days after the last restore, even after `uninstall`. To delete unused snapshots sooner, run `cf-orbs snapshots prune --all --yes` before you uninstall. Snapshots in a project mapping and orb disks stay. See [Manage snapshots](/docs/guides/manage-snapshots/).

## Also do

- In Amp, remove the provider (Settings → Orbs).
- For a Workers Builds install, disconnect the repo first (Settings → Builds → Disconnect), or the next push deploys the Worker again.

Source: https://cf-orbs-site.mdick85.workers.dev/docs/guides/uninstall/index.mdx