core/skills/remove/SKILL.md
Remove service container, quadlet file, and charly.yml entry. MUST be invoked before any work involving: charly remove command, cleaning up containers, removing quadlets, or purging volumes.
npx skillsauth add overthinkos/overthink-plugins removeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Removes a service container along with its quadlet file and charly.yml entry. Optionally purges named volumes and runs lifecycle hooks before removal.
| Action | Command | Description |
|--------|---------|-------------|
| Remove container | charly remove <image> | Remove container, quadlet, and deploy entry |
| Purge volumes | charly remove <image> --purge | Also remove named volumes |
| Keep deploy entry | charly remove <image> --keep-deploy | Keep charly.yml entry for re-configuration |
| With env vars | charly remove <image> -e KEY=VALUE | Pass env vars to pre_remove hooks |
# Remove a service (container + quadlet + charly.yml entry)
charly remove jupyter
# Remove and purge all named volumes
charly remove ollama --purge
# Remove but keep charly.yml entry for later re-configuration
charly remove immich --keep-deploy
# Pass environment variables to pre_remove hooks
charly remove openclaw -e CLEANUP_MODE=full
| Flag | Description |
|------|-------------|
| --purge | Also remove named volumes associated with the image |
| --keep-deploy | Preserve the charly.yml entry (useful for re-running charly config) |
| -e, --env KEY=VALUE | Pass environment variables to pre_remove lifecycle hooks |
pre_remove lifecycle hooks (if defined in image labels)--keep-deploy)--purge: removes named volumes (charly-<image>-<name>)Images can define pre_remove hooks that run before the container is removed. These are useful for graceful shutdown, data export, or cleanup tasks. Use -e to pass context to hooks.
Remove specific instances with -i:
charly remove selkies-desktop -i 192.241.92.221 # Remove instance
charly remove selkies-desktop -i 192.241.92.221 --purge # Also purge volumes
Instance removal automatically cleans the instance's env_provide and mcp_provide from charly.yml provides section. Other instances of the same base image are unaffected.
/charly-build:pull -- Prerequisite: fetch the image into local storage; handles remote refs (@github.com/...) and the ErrImageNotLocal recovery path
/charly-core:stop -- Stop without removing
/charly-core:charly-config -- Configure/reconfigure services (see "Full instance removal" for 3-step cleanup)
/charly-core:deploy -- Deploy.yml management, tunnel configuration
/charly-core:service -- Full service lifecycle
/charly-build:charly-mcp-cmd -- after charly config remove cleans this instance's mcp_provide from the global provides.mcp: list, consumers' CHARLY_MCP_SERVERS no longer lists it; use charly eval mcp servers <consumer> to confirm the cleanup propagated
tools
OpenCharly CLI (charly) binary installed into container/VM images for in-container use. Use when working with charly binary deployment inside containers, native D-Bus support, or the full charly toolchain (charly binary + virtualization + gocryptfs + socat).
development
Operator CachyOS workstation profile — a kind:local template + target:local deploy that installs the full dev stack (30 candies) onto a CachyOS host via ShellExecutor. Lives in the overthinkos/cachyos submodule. MUST be invoked before editing or applying the charly-cachyos workstation profile.
tools
Fedora box with the full charly toolchain using shared candies. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Same candy list as charly-arch. Includes NVIDIA GPU runtime. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-fedora box.
tools
Arch Linux box with the full charly toolchain. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Composes /charly-coder:charly-mcp so the box is reachable as an MCP gateway on port 18765. NVIDIA GPU runtime composed in. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-arch box.