Skip to content
SHC Docs

shc container mount

snapshot a container’s filesystem to a path on the daemon host

Copy a running container’s filesystem (docker export) into a directory under the daemon’s state directory and print its path. The copy is a snapshot: later writes inside the container do not reach it, and writes to it never reach the container. It is read-only unless --read-write.

The mount is leased: the daemon deletes the copy when --ttl runs out (1h by default). Release it sooner with shc volume umount <handle>; shc volume mounts lists what is held.

shc container mount <container-id> [flags]
-h, --help help for mount
--read-write mount it writable; the default is read-only
--ttl duration how long the mount lives before the daemon releases it (default 1h, at most 24h)
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-s, --stack string stack name (default: $SHC_STACK)
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)