Skip to content
SHC Docs

shc search

search available applications

Search the catalog: every kind of application the registered repositories publish. Kind is a filter, not a different verb: you usually do not know whether the thing you want is an app, a vapp or an addon, and finding out is the point.

A row that cannot be installed on its own is still listed, with its precondition in the requires column. --installable narrows to the rows with none.

shc search [query] [flags]
-c, --category string filter by category
-h, --help help for search
--include-hidden reveal hidden applications (they are synced and installable either way)
--installable only applications with no unmet precondition
--kind string filter by kind (app | vapp | addon | vaddon)
-r, --repo string filter by repository name
-v, --verbose show detailed information
--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)
  • shc - Selfhosted Cloud CLI