Skip to content

CLI Machines Docker Rm

github-actions[bot] edited this page Aug 23, 2026 · 2 revisions

ed machines docker rm

Removes a container, killing it first.

ed machines docker rm [--json] [--yes] <machine> <container>...

Arguments

Name Type / values Default What it does
<machine> machine name, ssh alias, id, or any unambiguous prefix required Which machine to act on.
<container>... one or more container names or ids at least one required Which containers to remove. Docker is given all of them in one call.

Options

Name Type / values Default What it does
--json flag off Emit JSON on stdout instead of the one-line confirmation.
--yes flag off Apply the removal. Without it, print the exact plan.
--help, -h flag off Print the help for this command on stdout and exit 0.

--json shape

{
  "action": "rm",
  "applied": false,
  "changed": false,
  "containers": [
    "open-webui"
  ],
  "machine": "Asus TUF 7",
  "targets": [
    "Asus TUF 7:container:open-webui"
  ]
}

Examples

ed machines tuf docker rm open-webui
ed machines tuf docker rm b556d7fef23e --yes --json

Behaviour notes

The remote command is docker rm -f <container>, so this kills a running container and removes it in one step rather than refusing to touch it. Without --yes, the command prints the resolved machine and every container target, changes nothing, and never opens an SSH connection. The container's writable layer goes with it, and anything the container wrote outside a volume or a bind mount is gone. Named volumes survive, because -v is never passed.

Runs under a 120 second ceiling. Failure exits 1 with docker's stderr as the hint. This is the Docker window's remove button, running the same command.

Where to go next

CLI reference

Getting Started
Config
App
Extensions
Permissions
Usage
System
Music
Calendar
Clipboard
Color
Download
Apps
Tools
Shelf
Cleaner
Machines
Machines Remote
Machines Docker
Machines Files
Machines Power
Machines Workspace
Attention
Companion
Herdr
Lid Awake
Machines Terminal
Machines Thermal

Guides

Clone this wiki locally