houstonj1/psql repository overview

⁠houstonj1/psql

A tiny Alpine image with the PostgreSQL client and DNS/network troubleshooting tools — handy for connecting to a database, running ad-hoc queries, or debugging connectivity from inside a cluster or CI job.

The design goal is freshness. Packages install from Alpine's current repositories and the image is rebuilt weekly, so latest always tracks the latest stable client. Security comes from frequent rebuilds (fresh packages + base patches) gated by container scanning, not from version pinning.

⁠Tags

psql is Alpine-based and has no -slim tag. Platforms: linux/amd64, linux/arm64.

⁠Usage

# Connect and run an interactive session
docker run --rm -it houstonj1/psql psql -h db.example.com -U app mydb

# Drop into a shell with the tools available (no args)
docker run --rm -it houstonj1/psql

# Debug DNS / connectivity
docker run --rm -it houstonj1/psql dig db.example.com

The image runs as the non-root psql user; the default command is bash.

⁠What's inside

• alpine:3 (apk upgrade applied at build)
• postgresql-client (psql, pg_dump, …)
• bind-tools (dig, nslookup, host)
• curl
• bash

⁠Security posture

• Latest-stable, not pinned — packages from current Alpine repos, rebuilt weekly.
• Patched base — apk upgrade --no-cache at build, no cached package indexes left behind.
• Hardened — runs non-root and carries OCI labels.
• Scanned — every published image is gated by container scanning.