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 the 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. |
| 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_CLOUD_HOST | pipes.turbot.com | Set the Turbot Pipes host, for connecting to Turbot Pipes workspace. |
| STEAMPIPE_CLOUD_TOKEN | Set the Turbot Pipes authentication token for connecting to Turbot Pipes workspace. | |
| 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_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_INSTALL_DIR | ~/.steampipe | The directory in which the Steampipe database, plugins, and supporting files can be found. |
| STEAMPIPE_INTROSPECTION | none | Enable introspection tables that allow you to query the mod resources in the workspace. |
| STEAMPIPE_LOG | warn | Set the logging output level [DEPRECATED - use STEAMPIPE_LOG_LEVEL]. |
| STEAMPIPE_LOG_LEVEL | warn | Set the logging output level. |
| STEAMPIPE_MAX_PARALLEL | 10 | Set the maximum number of parallel executions. |
| STEAMPIPE_MOD_LOCATION | current working directory | Set the workspace working directory. |
| STEAMPIPE_OTEL_LEVEL | NONE | Specify which OpenTelemetry data to send via OTLP. |
| 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. |