nsyte undeploy

Completely remove a deployed site: delete all blobs from blossom servers and remove the site manifest from relays. This is the nuclear option for fully taking down a site.

Usage

nsyte undeploy [options]

Options

• -r, --relays <relays> — Nostr relays to use (comma-separated)
• -s, --servers <servers> — Blossom servers to delete blobs from (comma-separated)
• --sec <secret> — Secret for signing (auto-detects: nsec, nbunksec, bunker://, hex)
• --prompt-sec — Prompt for the signing secret at runtime instead of --sec (keeps it out of shell history)
• -d, --name <name> — Site identifier for named sites. If not provided, undeploys root site
• --dry-run — Preview undeploy events without publishing or deleting blobs (default: false)
• --dry-run-output <dir> — Directory to write dry-run event JSON files
• --dry-run-show-kinds <kinds> — Also print events of these kinds to stdout (comma-separated kind numbers)
• -y, --yes — Skip confirmation prompts (default: false)

Examples

Undeploy root site:

nsyte undeploy

Undeploy a named site:

nsyte undeploy -d blog

Undeploy in CI (skip type-to-confirm):

nsyte undeploy --yes --sec $NBUNK_SECRET

Undeploy with custom relays and servers:

nsyte undeploy -r wss://relay1.com,wss://relay2.com -s https://server1.com

Preview the manifest delete event and blob count without changing anything:

nsyte undeploy --dry-run --dry-run-show-kinds 5

How it Works

1. Fetches manifest: Retrieves the current site manifest from relays
2. Shows summary: Displays number of blobs, servers, and relays affected
3. Type-to-confirm: Requires typing the site name (or "undeploy" for root sites) to confirm
4. Deletes blobs: Removes all blob files from all configured blossom servers
5. Removes manifest: Publishes NIP-09 Kind 5 delete event for the site manifest

Unlike delete, which selectively removes site events, undeploy always deletes both the blobs from blossom servers and the manifest from relays.

Confirmation

The undeploy command uses a type-to-confirm prompt for safety:

This will delete 42 blobs from 2 servers and remove the site manifest from 3 relays.
  - /index.html
  - /about.html
  - /assets/style.css
  ...and 39 more files

Type "undeploy" to confirm:

For named sites, you type the site name instead:

Type "blog" to confirm:

Use --yes to skip the confirmation prompt in CI/CD pipelines.

Authentication

The undeploy command requires authentication to:

• Sign delete events for the manifest
• Authenticate blob deletion requests on blossom servers

Authentication options (in order of precedence):

1. --sec command line option
2. Bunker configured in the project (bunkerPubkey)

Error Handling

• If no blossom servers are configured, blob deletion is skipped with a warning
• Individual blob deletion failures are logged but don't stop the process
• At least one successful relay publish is required for the manifest deletion
• Shows a results summary at the end

See Also

• nsyte delete - Selectively remove site events from relays
• nsyte deploy - Deploy files to create nsites
• nsyte ls - List published files
• nsyte download - Download files for backup

Inherits global options. See global options.