Skip to content
SHC Docs

shc export mount

mount an export artifact and print a directory to browse

Mount a .exp export artifact for browsing.

The artifact’s payload checksum is verified before anything is unpacked, so a corrupted artifact is refused rather than served. The mount is daemon-resident and survives this CLI exiting; release it with shc export umount, naming its id or the artifact.

Unlike shc backup mount this is not a FUSE mount: the payload is gzipped, so it has to be inflated once up front, and what you get back is the real directory holding the inflated tree. Reads from it are ordinary file reads.

That directory is a full-size copy of the payload and is only reclaimed by shc export umount, so release mounts you are done with. It is created 0700 under the daemon user because an export can carry credentials.

An artifact with no files in it is refused rather than mounted: an empty path is indistinguishable from a broken one.

shc export mount <artifact> [flags]
-h, --help help for mount
--idle-ttl int seconds of inactivity before the daemon may reclaim the mount (0 = daemon default)
--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 name of the stack to export from
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc export - export deployment data to an archive