cmd uninstall - nself-org/cli GitHub Wiki

nself uninstall

Remove nSelf-generated files and containers from the current project directory.

Synopsis

nself uninstall [flags]

Description

nself uninstall stops running containers and deletes files that nSelf generated for the current project: docker-compose.yml, the nginx site configs in nginx/sites/, and the .nself/cache/ directory. Your .env* files, hand-managed nginx/conf.d/ fragments, and application source code are never touched.

By default the command keeps Postgres database volumes so your data survives the removal. Add --purge to also delete the volumes. The command is interactive by default: it describes what it will do and prompts for confirmation before proceeding. Use --yes to skip prompts in scripted or CI environments.

Warning: Data Loss Risk. Running nself uninstall --purge permanently deletes the Postgres database volumes for this project. This action cannot be undone. Keep a backup before running --purge, or omit the flag to preserve your data.

Flags

Flag	Short	Type	Default	Description
`--keep-data`		bool	`false`	Keep database volumes (the default behaviour when no flag is given)
`--purge`		bool	`false`	Remove everything including database volumes. Destructive and permanent
`--yes`	`-y`	bool	`false`	Skip all confirmation prompts

--keep-data and --purge are mutually exclusive.

Examples

# Interactive uninstall, keeps DB volumes (default)
nself uninstall

# Same as default, explicit flag
nself uninstall --keep-data

# Remove everything including the database (prompts for "purge" confirmation)
nself uninstall --purge

# Non-interactive full purge for CI teardown
nself uninstall --purge --yes

# Reinitialise from scratch after uninstall
nself init --force && nself build && nself start