A database explorer for Postgres and SQLite in one binary under 3 MB.
Browse and query in your browser, or run SQL from the shell.
Website · Live demo · Features · Install · Usage · Docker · Development
Postgres: schemas, views and functions, a filtered and sorted table, and a foreign key followed in the inspector
SQLite: a query in the SQL editor, its results, and a JSON value formatted in the inspector
| Browse | Every schema, table, view and function. A grid that pages through any table, with filters and sorting from a builder or your own WHERE and ORDER BY. |
| Inspect | Each row formatted, JSON included, with foreign keys you can follow. Each table's structure, indexes, triggers, DDL and relationships. |
| Query | A SQL editor with highlighting and completion. It runs the statement at the caret, the selection or the whole script, and asks before anything that destroys data. |
| Share | Every view lives in the URL. Copy cells and rows as CSV, TSV, JSON or Markdown, or save them as a file. |
| Shell | zetta query prints a table, CSV or JSON, and zetta tables lists what is there. Completions for bash, zsh and fish. |
| Safe | Listens on 127.0.0.1 with a fresh token each run, and refuses other hosts and origins. --read-only is enforced in the database adapter, not the UI. Passwords never reach a log. |
| Small | One binary with the UI embedded, its own Postgres client with TLS, and SQLite compiled in. No libpq, no OpenSSL. |
Linux and macOS
curl -fsSL https://raw.githubusercontent.com/dagimg-dot/zetta/main/install.sh | shThe script picks the build for your system, checks it against the release's SHA256SUMS and installs zetta to /usr/local/bin, or ~/.local/bin when that is not writable. Set ZETTA_VERSION to pin a release or ZETTA_INSTALL_DIR to choose the directory.
Arch Linux, from the zetta-bin PKGBUILD in this repository (with bash, zsh and fish completions):
git clone --depth 1 https://github.com/dagimg-dot/zetta
cd zetta/packaging/aur/zetta-bin && makepkg -siManual download from the latest release:
| Platform | Archive |
|---|---|
| macOS, Apple Silicon | zetta-<version>-macos-aarch64.tar.gz |
| Linux, x86_64 | zetta-<version>-linux-x86_64.tar.gz |
| Linux, arm64 | zetta-<version>-linux-aarch64.tar.gz |
| Windows, x64 | zetta-<version>-windows-x86_64.zip |
| Windows, arm64 | zetta-<version>-windows-aarch64.zip |
On macOS, clear the download quarantine of a manual download once with xattr -d com.apple.quarantine zetta.
Docker: docker pull workflowjd/zetta, then see Docker.
From source with Zig 0.16.0 and bun:
cd web && bun install && cd ..
zig build -Doptimize=ReleaseSafe # the binary is zig-out/bin/zettazetta ./app.db # browse a SQLite file
zetta postgres://me@localhost/app --read-only # browse Postgres without writes
zetta query app.db 'select * from users limit 5' # print a result
zetta query postgres://me@localhost/app -f csv < report.sql > report.csv
zetta tables app.db # list schemas and tableszetta prints a URL with a one-time token and opens it in your browser, on port 1993 or the next free one. A database is a postgres:// URL, a Postgres keyword string (host=... dbname=...) or a SQLite file. Set DATABASE_URL instead of passing it to keep a password out of the process list. zetta <command> --help lists every option, and every flag also has an environment variable.
export ZETTA_TOKEN=$(openssl rand -hex 16)
# Postgres
docker run --rm -p 127.0.0.1:1993:1993 -e ZETTA_TOKEN \
-e DATABASE_URL=postgres://user:password@db:5432/app workflowjd/zetta
# A SQLite file in the current directory
docker run --rm -p 127.0.0.1:1993:1993 -e ZETTA_TOKEN \
--user "$(id -u):$(id -g)" -v "$PWD:/data" workflowjd/zetta serve /data/app.dbThen open http://localhost:1993/?token=$ZETTA_TOKEN. Inside the container zetta listens on all interfaces, so it needs ZETTA_TOKEN (16 to 64 letters and digits). It serves plain HTTP, so keep the port on 127.0.0.1 unless a TLS proxy is in front. --user lets the container open a file you own.
The image is a static binary on scratch for amd64 and arm64, also published as ghcr.io/dagimg-dot/zetta. latest is the newest release and edge follows main.
Add zetta beside the database your project already runs:
services:
db:
image: postgres:17
environment:
POSTGRES_PASSWORD: postgres
zetta:
image: workflowjd/zetta
ports: ["127.0.0.1:1993:1993"]
environment:
ZETTA_TOKEN: ${ZETTA_TOKEN:?set ZETTA_TOKEN in .env}
DATABASE_URL: postgres://postgres:postgres@db:5432/postgres
depends_on: [db]Put ZETTA_TOKEN= and the output of openssl rand -hex 16 in .env, run docker compose up, and open the link docker compose logs zetta prints. In the image zetta keeps trying the database for 30 seconds while it starts, so it needs no health check; ZETTA_WAIT changes how long. Add ZETTA_READ_ONLY: "true" to browse a shared database without writes. For SQLite, mount the file's folder and pass command: ["serve", "/data/app.db"], with user: set to your own uid and gid.
Postgres support
- URLs and keyword strings parsed as libpq does,
PG*environment variables and~/.pgpass - SCRAM-SHA-256, MD5, cleartext password and trust
- Every
sslmodefromdisabletoverify-full, withsslrootcert=<file>or the system store - TCP, IPv6 and Unix sockets
- Not supported: channel binding, client certificates, Kerberos, multiple hosts and
COPY FROM STDIN
--read-only opens SQLite read-only. On Postgres it runs each statement in a read-only transaction and refuses DO and CALL. For a hard guarantee, connect as a read-only role.
zig build check # format check and full build
zig build test # unit tests and the adapter suite
cd web && bun run check # types, lint and UI tests
cd web && bun run dev # UI dev server, proxies /api to zetta on port 1993ZETTA_TEST_PG_URL=postgres://... zig build test test-oracle -Dpg-oracle=true also runs the suite on Postgres and compares it with libpq, and dev/pg-matrix.sh covers auth, TLS and sslmode against real servers in Docker.
zetta is in early development. Issues and pull requests are welcome.
MIT. The binary also carries SQLite (public domain), solid-js and Ark UI (MIT), and the Lexend and Source Code Pro fonts (SIL Open Font License 1.1).