Skip to content
SHC Docs

shc clone

clone a deployment

Clone a deployment to a new stack name, environment, or tenant. The command plans the clone first; --dry-run prints the plan and stops, and a run without --yes must be on a terminal. --all-connections clones the deployment’s entire integration graph, with --rename remapping dependency names (= pairs). A clone never names a node: the copy is placed by the source deployment’s own rules plus any --where or --prefer given, and --runtime and --storage override the source’s.

shc clone <source> <target> [flags]
shc clone myblog myblog-staging
shc clone myblog blog2 --target-environment staging
shc clone myblog blog2 --where 'location=hetzner/hel1'
shc clone mydb mydb-copy -a --rename myblog=myblog-copy
shc clone myblog blog2 --dry-run
-a, --all-connections carry the source's one-hop integration neighbourhood as well
--closure with -a: carry the transitive integration set, not just one hop, needed when a peer has providers of its own; refused above a handful of deployments
--dry-run show what would be cloned without executing
-h, --help help for clone
--prefer string nodes this copy prefers
-q, --quiet suppress progress output
-r, --rename string rename dependencies (<old>=<new>[,<old>=<new>...])
--runtime string target runtime (docker|podman|incus|apple)
--storage string target storage backend for the cloned deployment
--target-environment string target environment
--target-tenant string target tenant
--where string nodes this copy may run on
-y, --yes skip confirmation prompt
--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)
  • shc - Selfhosted Cloud CLI