Environment Variables
Steampipe supports environment variables to allow you to change its default behavior. These are optional settings - You are not required to set any environment variables.
Note that plugins may also support environment variables, but these are plugin-specific - refer to your plugin's documentation on hub.steampipe.io for details.
Steampipe Environment Variables
| Command | Default | Description |
|---|---|---|
| PIPES_HOST | pipes.turbot.com | Set the Turbot Pipes host, for connecting to Turbot Pipes workspace. |
| PIPES_TOKEN | Set the Turbot Pipes authentication token for connecting to Turbot Pipes workspace. | |
| STEAMPIPE_CACHE | true | Enable/disable caching. |
| STEAMPIPE_CACHE_MAX_SIZE_MB | unlimited | Set the maximum size of the query cache across all plugins. [DEPRECATED - use STEAMPIPE_PLUGIN_MEMORY_MAX_MB]. |
| STEAMPIPE_CACHE_MAX_TTL | 300 | The maximum amount of time to cache results, in seconds. |
| STEAMPIPE_CACHE_TTL | 300 | The amount of time to cache results, in seconds. |
| STEAMPIPE_DATABASE_PASSWORD | randomly generated | Set the steampipe database password for this session. This variable must be set when the steampipe service starts. |
| STEAMPIPE_DATABASE_SSL_PASSWORD | Set the passphrase used to decrypt the private key for your custom SSL certificate. By default, Steampipe generates a certificate without a passphrase; you only need to set this variable if you use a custom certificate that is protected by a passphrase. | |
| STEAMPIPE_DATABASE_START_TIMEOUT | 30 | Set the maximum time (in seconds) to wait for the Postgres process to start accepting queries after it has been started. |
| STEAMPIPE_DIAGNOSTIC_LEVEL | NONE | Sets the diagnostic level. Supported levels are ALL, NONE. |
| STEAMPIPE_INSTALL_DIR | ~/.steampipe | The directory in which the Steampipe database, plugins, and supporting files can be found. |
| STEAMPIPE_LOG | warn | Set the logging output level [DEPRECATED - use STEAMPIPE_LOG_LEVEL]. |
| STEAMPIPE_LOG_LEVEL | warn | Set the logging output level. |
| STEAMPIPE_MEMORY_MAX_MB | 1024 | Set a soft memory limit for the steampipe process. |
| STEAMPIPE_OTEL_INSECURE | false | Bypass the SSL/TLS secure connection requirements when connecting to an OpenTelemetry server. |
| STEAMPIPE_OTEL_LEVEL | NONE | Specify which OpenTelemetry data to send via OTLP. |
| STEAMPIPE_PLUGIN_MEMORY_MAX_MB | 1024 | Set a default memory soft limit for each plugin process. |
| STEAMPIPE_QUERY_TIMEOUT | 240 for controls, unlimited in all other cases. | Set the amount of time to wait for a query to complete before timing out, in seconds. |
| STEAMPIPE_SNAPSHOT_LOCATION | The Turbot Pipes user's personal workspace | Set the Turbot Pipes workspace or filesystem path for writing snapshots. |
| STEAMPIPE_TELEMETRY | info | Set the level of telemetry data to collect and send. |
| STEAMPIPE_UPDATE_CHECK | true | Enable/disable automatic update checking. |
| STEAMPIPE_WORKSPACE | default | Set the Steampipe workspace . This can be named workspace from workspaces.spc or a remote Turbot Pipes workspace |
| STEAMPIPE_WORKSPACE_DATABASE | local | Workspace database. This can be local or a remote Turbot Pipes database. |