WendyOS Docs
Detailed referenceClientsWendy cliCommandsDeviceApps

Remove

Removes an app from the device. With an [app-name] argument, removes that app; otherwise lists all apps and allows interactive removal.

Removes an app from the device. With an [app-name] argument, removes that app; otherwise lists all apps and allows interactive removal.

wendy device apps remove [app-name] [flags]

Flags

FlagDescription
--cleanupAlso remove the container image, reclaiming disk space.
--delete-volumesAlso delete the app's persistent volumes.
--forceSkip confirmation prompts. Required without an interactive terminal.

When neither --cleanup nor --delete-volumes is given and --force is absent, the command shows an interactive "Also clean up?" checklist offering to delete the container image and the persistent volumes, so the cleanup choices are still reachable without passing flags.

Without an interactive terminal there is nobody to answer the confirmation, so remove refuses to run unless --force is given, exiting with status 2 (a usage error).

JSON output

With --json (automatic when stdout is not a terminal) the command prints one JSON object to stdout. deleteImage and deleteVolumes appear when those clean-ups were requested; status is cancelled if the removal was declined at the prompt.

{"app": "my-app", "action": "remove", "status": "removed", "deleteImage": true}

On this page