A web-based GUI for browsing and editing Valkey/Redis databases. Inspired by pgweb.
Go backend with embedded Svelte frontend in a single binary.
Features
- Browse and edit string, hash, list, set, sorted set, stream, HyperLogLog, and geo keys
- Search with glob patterns or regex, filter by type, sort by name/type/TTL/memory
- Tree view for navigating keys by prefix hierarchy, or flat list view
- Inline editing with per-type editors — rename fields, adjust scores, update coordinates
- Live updates via WebSocket keyspace notifications to see changes as they happen
- Command console for running ad-hoc Valkey commands
- Compressed values — gzip and zstd auto-detected, decompressed for display, re-compressed on save
- Geo map view — plot sorted set members on an interactive OpenStreetMap
- JSON syntax highlighting with compact/formatted toggle
- Dark mode with system preference detection and manual toggle
- Read-only mode — disable all writes via
--readonly - Prefix isolation — restrict visible keys with
--prefix - Bulk operations — multi-select keys for batch delete
- Keyboard shortcuts — delete, select all, range select, console toggle
- Copy to clipboard — copy key names or full values in one click
- TTL management — set, edit, and watch live countdowns
Install
Download the latest binary from GitHub Releases, extract it, and add it to your PATH.
With Docker:
docker run --rm -p 8080:8080 ghcr.io/natrimmer/kvweb -url host.docker.internal:6379
With Nix:
nix profile install github:natrimmer/kvweb
Or build from source (requires Go, Node.js, pnpm):
git clone https://github.com/natrimmer/kvweb
cd kvweb
build
Usage
| Flag | Default | Description |
|---|---|---|
-url |
localhost:6379 |
Server address or URL (see below) |
-password |
Server password (prefer VALKEY_PASSWORD env var) |
|
-db |
0 |
Database number |
-host |
localhost |
HTTP listen address |
-port |
8080 |
HTTP listen port |
-readonly |
false |
Disable write operations |
-prefix |
Only show keys matching this prefix | |
-disable-flush |
true |
Block FLUSHDB even in write mode |
-max-keys |
0 |
Limit SCAN count per request (0 = no limit) |
-notifications |
false |
Auto-enable keyspace notifications for live updates |
-open |
false |
Open browser on start |
-dev |
false |
Skip serving embedded frontend (API + WebSocket only) |
Connection URLs
The -url flag accepts a plain host:port or a full URL with scheme:
kvweb -url localhost:6379
kvweb -url redis://:password@localhost:6379/2
kvweb -url rediss://host:6380
Supported schemes: redis://, rediss:// (TLS), valkey://, valkeys:// (TLS), unix://.
The URL can include username, password, and database number. The -password and -db flags override values from the URL when set.
The rediss:// and valkeys:// schemes enable TLS with system CA certificates. Custom CA certs, client certificates, and other advanced TLS settings are not supported through the URL.
Versioning
kvweb uses SemVer with git tags as the source of truth. The version and commit hash are embedded at build time via git describe.
git tag -a v0.2.0 -m "v0.2.0"
git push origin v0.2.0
kvweb --version
kvweb v0.2.0 (a1b2c3d)