Skip to main content
Version: 3.2.6

Resoto Shell

The resh command starts Resoto Shell (resotoshell), which is used to interact with resotocore.

Resoto Shell allows you to explore the graph, find resources of interest, mark them for cleanup, fix their tagging, aggregate over their metadata to create metrics, and format the output for use in a third-party script or system.

Please refer to Command-Line Interface for details on how to use Resoto Shell.


Resoto Shell can be run via Docker or installed via pip. On macOS, you can also install it via Homebrew.

Resoto Shell Docker image
Resoto Shell Python 3.9+ PIP install
pip install --user resotoshell
Homebrew installation
brew install someengineering/tap/resotoshell



--resotocore-uri <RESOTOCORE_URI>Resoto Core URI (default: https://localhost:8900)
--resotocore-section <RESOTOCORE_SECTION>All queries are interpreted with this section name. If not set, the server default is used.
--resotocore-graph <RESOTOCORE_GRAPH>The name of the graph to use by default. If not set, the server default is used.
--download-directory <DOWNLOAD_DIRECTORY>If files are received, they are written to this directory.
--no-colorOutput should be rendered plain without any color escape sequences.
--stdinRead from STDIN instead of opening a shell
--verbose, -vVerbose logging
--quietOnly log errors
--psk <PSK>Pre-shared key
--ca-cert <CA_CERT>Path to custom CA certificate file
--no-verify-certsTurn off certificate verification

Environment Variables

CLI options can also be set via environment variables. The environment variable name is the same as the option name, but in uppercase with the prefix RESOTOSHELL_ and dashes replaced by underscores.

For example, --resotocore-uri https://foobar.tld:8900 would become RESOTOSHELL_RESOTOCORE_URI=https://foobar.tld:8900.