Usage
Flags
| Flag | Type | Default | Description |
|---|
--volumes | bool | false | Also remove Docker volumes (persistent data) |
--service | string[] | all | Stop specific service(s) only |
--timeout | duration | 30s | Maximum time to wait for graceful shutdown |
Description
Stops and removes all containers, networks, and optionally volumes associated with the current project. Also cleans up the state file at ~/.dokrypt/state/.
The shutdown process:
- Load state — Reads the project state file to find running containers
- Stop containers — Sends SIGTERM, waits for graceful shutdown
- Remove containers — Removes stopped containers
- Remove network — Removes the project Docker network (only if all services stopped)
- Remove volumes — If
--volumes is set, removes persistent data
- Clean state — Removes the state file
Examples
Stop everything
Stop and remove all data
Using --volumes permanently deletes chain state, IPFS data, and all other persistent data. This cannot be undone.
Stop a specific service
dokrypt down --service ipfs
Custom shutdown timeout
dokrypt down --timeout 60s
Errors
| Error | Cause | Solution |
|---|
No running stack found | No state file exists | Services may have already been stopped |
Docker is not running | Docker daemon is not started | Start Docker to clean up orphaned containers |