cmd remove

nself remove

Remove an installed plugin or bundle.

Plugin data. In v1.4 mode a plugin remove drops the plugin's schema/tables unless --keep-data, and warns when it does so by default. From v1.5 (NSELF_V15=1) a plugin remove keeps the data, as a bundle remove does; --delete-data drops it and needs --yes or a y answer on a terminal, otherwise it stops with E403 (exit 4) and removes nothing. --force past E133 (a plugin a bundle still references) does not change this. See Compat-V15.

Synopsis

nself remove <name> [flags]

Alias: nself rm

Description

Remove an installed plugin or bundle by name.

This is the short form of nself plugin remove. As with install, a bundle name removes the whole bundle.

Flags

Name	Shorthand	Type	Default	Env	Escalates to	JSON override	Description
--delete-data		bool	false				Delete plugin data (schema/tables). A bundle remove asks for confirmation (or pass --yes); a plugin remove never asks and drops data unless --keep-data
--dry-run		bool	false				Print the planned actions without removing
--force		bool	false				Remove even if other plugins depend on this one
--keep-data		bool	false				Preserve database data on remove
--yes		bool	false				Skip confirmation prompts
--help	-h	bool	false				Show help

Contract

• Side effect: destructive
• Output: document
• JSON: envelope (data schema)
• Exit codes: none declared

Examples

nself remove waf
  nself remove nchat
  nself remove waf --delete-data --yes   # v1.5: also drop the plugin's data

See Also

• Commands — full command index
• Core-Services — what a stack is made of

← Commands | Home →