Skip to content

devops-ia/steampipe

steampipe

CI GitHub release Docker Hub Docker Pulls License: MIT

Community Docker image for Steampipe — use SQL to instantly query cloud services (AWS, Azure, GCP and more).

Why this image? Turbot stopped publishing official Docker images after Steampipe v0.22.0. This project provides multi-arch container images built from official pre-compiled binaries.

Quick start

# Run Steampipe as a service (PostgreSQL endpoint on port 9193)
docker run -d --name steampipe \
  -p 9193:9193 \
  ghcr.io/devops-ia/steampipe:2.4.1 \
  steampipe service start --foreground --database-listen network

# Install a plugin
docker exec steampipe steampipe plugin install aws

# Connect with any PostgreSQL client
psql -h localhost -p 9193 -U steampipe -d steampipe

Image details

Property Value
Base image debian:bookworm-slim
Architectures linux/amd64, linux/arm64
User steampipe (UID 9193, GID 0)
Port 9193 (PostgreSQL)
Default CMD steampipe service start --foreground

Registries

# GitHub Container Registry
docker pull ghcr.io/devops-ia/steampipe:2.4.1

# Docker Hub
docker pull devopsiaci/steampipe:2.4.1

Documentation

Topic Description
Getting Started Docker, Docker Compose, plugin install, first query
Configuration Environment variables, .spc plugin configs, memory tuning
Kubernetes Helm chart, OpenShift, Secrets, health checks
Examples AWS queries, multi-cloud, Python/Node/Go clients, security audits
Troubleshooting Connection errors, permissions, OOM, debug mode

Versioning

Image versions track upstream Steampipe releases 1:1. New versions are detected automatically via updatecli and published after merge.

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.

Community Docker image for Steampipe — use SQL to instantly query cloud services (AWS, Azure, GCP and more).

Why this image? Turbot stopped publishing official Docker images after Steampipe v0.22.0. This project provides multi-arch container images built from official pre-compiled binaries.

Quick start

# Run Steampipe as a service (PostgreSQL endpoint on port 9193)
docker run -d --name steampipe \
  -p 9193:9193 \
  ghcr.io/devops-ia/steampipe:2.4.1 \
  service start --foreground --database-listen network

# Install a plugin
docker exec steampipe steampipe plugin install aws

# Connect with any PostgreSQL client
psql -h localhost -p 9193 -U steampipe -d steampipe

Image details

Property Value
Base image debian:bookworm-slim
Architectures linux/amd64, linux/arm64
User steampipe (UID 9193, GID 0)
Port 9193 (PostgreSQL)
Entrypoint steampipe
Default CMD service start --foreground

Registries

# GitHub Container Registry
docker pull ghcr.io/devops-ia/steampipe:2.4.1

# Docker Hub
docker pull devopsiaci/steampipe:2.4.1

service start flags

Flag Description Default
--foreground Run in foreground (required for containers)
--database-listen Accept connections from local or network local
--database-port PostgreSQL port 9193
--database-password Set database password random
--show-password Show password in logs false

Environment variables

Container-optimized defaults are pre-configured. Override as needed:

Variable Image default Description
STEAMPIPE_UPDATE_CHECK false Disable update checking
STEAMPIPE_TELEMETRY none Disable telemetry
STEAMPIPE_LOG_LEVEL warn Logging level
STEAMPIPE_DATABASE_PASSWORD random Database password
STEAMPIPE_MEMORY_MAX_MB 1024 Process memory soft limit (MB)
STEAMPIPE_PLUGIN_MEMORY_MAX_MB 1024 Per-plugin memory soft limit (MB)
STEAMPIPE_CACHE true Enable/disable query cache
STEAMPIPE_CACHE_TTL 300 Cache TTL in seconds
STEAMPIPE_QUERY_TIMEOUT 240 Query timeout in seconds
STEAMPIPE_INSTALL_DIR /home/steampipe/.steampipe Installation directory
STEAMPIPE_DIAGNOSTIC_LEVEL NONE Diagnostic level (ALL, NONE)

Full reference: Steampipe Environment Variables

Kubernetes / Helm

This image is designed to work with the helm-steampipe Helm chart:

  • UID 9193 / GID 0 — compatible with OpenShift restricted SCC
  • Directory structure matches chart volume mounts (/home/steampipe/.steampipe/{config,internal,logs,plugins}, /workspace)
  • Shell available (/bin/bash, /bin/sh) for init container scripts

Versioning

Image versions track upstream Steampipe releases 1:1:

Image tag Steampipe version
2.4.1 v2.4.1

New versions are detected automatically via updatecli and published after merge.

License

MIT — see LICENSE.

About

Docker image for Steampipe - Zero-ETL, infinite possibilities. Live query APIs, code & more with SQL. No DB required.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors