HUB
Sign inSign up

dreaminhex/hexdb

By dreaminhex

•Updated 3 days ago

HexDB: encrypted, replicated document and file database. REST, GraphQL, SQL, vector search, MCP.

Image
Content management system
Databases & storage
Monitoring & observability
0

4.4K

dreaminhex/hexdb repository overview

⁠HexDB

An encrypted, replicated database for JSON documents and binary files, in one Rust binary: REST, GraphQL, gRPC and read-only SQL; full-text and vector search; an admin UI; streams, functions, triggers and plugins; and an MCP server and A2A agent for AI tools. Data is encrypted at rest (AES-256-GCM) and replicated across a lattice of hexes with automatic failover.

⁠Run one hex

docker run -d --name hexdb -p 7700:7700 -v hexdb-data:/var/lib/hexdb \
  -e HEXDB_STORAGE__ENCRYPTION_KEY="base64:$(openssl rand -base64 32)" \
  dreaminhex/hexdb
docker logs hexdb | grep -A2 "first administrator"   # the generated admin password

Open http://localhost:7700/ui/⁠ and sign in. Keep the encryption key: the data can't be read without it.

A slim image, ghcr.io/dreaminhex/hexdb:<version>-slim, has the server, the CLI and the admin UI only: no script runtimes (script functions are off), OCR or ffmpeg, and far fewer packages to patch.

The server writes only its volume, so it also runs with a read-only root file system and no Linux capabilities:

docker run -d --read-only --tmpfs /tmp --cap-drop ALL --security-opt no-new-privileges \
  -p 7700:7700 -v hexdb-data:/var/lib/hexdb -e HEXDB_STORAGE__ENCRYPTION_KEY="base64:..." dreaminhex/hexdb

⁠Configuration

/etc/hexdb/hexdb.toml holds the defaults; any setting can be overridden with HEXDB_<SECTION>__<FIELD>:

VariableMeaning
HEXDB_STORAGE__ENCRYPTION_KEYRequired: base64:<32 bytes> (docker run --rm --entrypoint hexdb dreaminhex/hexdb secret prints one)
HEXDB_NETWORK__LATTICE_NAMEThe same on every hex of a lattice
HEXDB_NETWORK__LATTICE_SECRETShared by every hex of a lattice
HEXDB_NETWORK__PEERSOther hexes' discovery addresses (host:7702), comma-separated
HEXDB_NETWORK__ADVERTISE_HOSTHow other hexes reach this one
HEXDB_SECURITY__ADMIN_PASSWORDThe first administrator's password (otherwise generated and printed once)

Ports: 7700 (API and admin UI), 7702 (discovery between hexes). Data: /var/lib/hexdb.

⁠A lattice

The repository's docker-compose.yml⁠ runs three hexes with failover. On Kubernetes, use the Helm chart:

helm install hexdb oci://ghcr.io/dreaminhex/charts/hexdb --set replicas=3

⁠Tags

latest, the version (2.2.0) and the release tag (v2.2.0), for linux/amd64 and linux/arm64. The same image is published as ghcr.io/dreaminhex/hexdb.

A forgotten admin password: docker exec -u hexdb hexdb hexdb reset-password.

Licensed under Apache 2.0.

Tag summary

Content type

Image

Digest

sha256:684fabed5…

Size

171.2 MB

Last updated

3 days ago

docker pull dreaminhex/hexdb