Skip to content
SHC Docs

shc tenant add

add a tenant

Create a new tenant: filesystem tree, overlay network, and Keycloak realm. By default switches to the new tenant and auto-provisions an admin user; the admin password is auto-generated and stored in the vault — retrieve it any time with shc vault get keycloak_admin_password -t <name>. Realm provisioning runs in the background and completes automatically.

shc tenant add <name> [flags]
--admin-password string explicit password for the admin user (default: auto-generated)
--admin-user string username for the auto-created admin user (default "admin")
-h, --help help for add
--no-admin skip auto-creating an admin user
--no-switch don't switch to the new tenant
--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: $SHC_ENVIRONMENT)
--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)