teneriscc/tamadb repository overview

⁠TamaDB

A document-centric transmission cache for smart-endpoints/dumb-pipes architectures — validated, versioned JSON document delivery between data producers and consumers.

TamaDB receives JSON documents, validates them against schemas, stores them temporarily with a configurable TTL, and pushes updates to registered consumers via webhooks. It is intentionally minimal: no complex queries, joins, or aggregations — its strengths are speed, schema enforcement, and reliable push delivery.

⁠Images

Images are multi-architecture: linux/amd64 and linux/arm64.

⁠Quick start

docker run --rm -p 3000:3000 teneriscc/tamadb:0.1.0

Verify it's up:

curl http://localhost:3000/health
# {"status":"ok","version":"0.1.0","storageMode":"auto","logLevel":"debug"}

⁠Persisting data

By default TamaDB writes state under /app/.tamadb-data. Mount a volume there to keep data across restarts:

docker run -p 3000:3000 -v tamadb-data:/app/.tamadb-data teneriscc/tamadb:0.1.0

⁠Run with Docker Compose

services:
  tamadb:
    image: teneriscc/tamadb:0.1.0
    container_name: tamadb
    ports:
      - "3000:3000"
    environment:
      TAMADB_LOG_LEVEL: "debug"      # debug | info | warn | error | silent
      TAMADB_STORAGE_MODE: "auto"    # auto | memory | disk | hybrid
    volumes:
      - tamadb-data:/app/.tamadb-data
    restart: unless-stopped

volumes:
  tamadb-data:

docker compose up -d

A ready-to-use compose.yaml (with a matching health check) is included in the source repository⁠.

⁠Configuration

All configuration is via environment variables (all optional):

# Example: quieter logs, in-memory only (no persistence)
docker run --rm -p 3000:3000 \
  -e TAMADB_LOG_LEVEL=info \
  -e TAMADB_STORAGE_MODE=memory \
  teneriscc/tamadb:0.1.0

⁠Image details

• Runs as a non-root user
• Ships a container HEALTHCHECK against /health
• Graceful shutdown on SIGTERM

⁠Documentation & source

• Source code: https://github.com/teneriscc/TamaDB⁠
• Project site: https://teneris.cc⁠
• API catalogue: https://teneris.cc/api-catalogue.html⁠

⁠License

Apache License 2.0.