Local-first, air-gapped AI Document Intelligence and Second Brain backend by Idea To Fact LLC.
87
bge-small-en-v1.5), ChromaDB vector search, BM25 keyword search, SQLite WAL metadata indexing, deterministic contract clause analysis, and local LLM integration via Ollama.127.0.0.1 so services are never exposed to external LAN/WAN interfaces.ANONYMIZED_TELEMETRY=False, DO_NOT_TRACK=1, and HF_HUB_OFFLINE=1.SovereignDoc pairs with a native Ollama instance running on your host machine to leverage hardware acceleration (NVIDIA CUDA / Apple Silicon Metal) without container overhead. Ensure Ollama is running on your host:
ollama run llama3.2:3b
Run the backend container bound strictly to localhost, connecting to host Ollama:
docker run -d \
--name sovereigndoc-backend \
-p 127.0.0.1:8000:8000 \
-e OLLAMA_BASE_URL="http://host.docker.internal:11434" \
-v sovereigndoc_data:/root/.sovereigndoc \
--add-host host.docker.internal:host-gateway \
--restart unless-stopped \
airgapaxis/sovereigndoc-backend:1.1.0-community
To run the complete stack (Backend + React Frontend), use the canonical docker-compose.yml:
services:
backend:
image: airgapaxis/sovereigndoc-backend:1.1.0-community
container_name: sovereigndoc-backend
ports:
- "127.0.0.1:8000:8000"
environment:
OLLAMA_BASE_URL: http://host.docker.internal:11434
SOVEREIGNDOC_HOST: 0.0.0.0
SOVEREIGNDOC_PORT: 8000
ANONYMIZED_TELEMETRY: "False"
DO_NOT_TRACK: "1"
volumes:
- sovereigndoc_data:/root/.sovereigndoc
extra_hosts:
- "host.docker.internal:host-gateway"
restart: unless-stopped
frontend:
image: airgapaxis/sovereigndoc-frontend:1.1.0-community
container_name: sovereigndoc-frontend
ports:
- "127.0.0.1:5173:5173"
depends_on:
- backend
restart: unless-stopped
volumes:
sovereigndoc_data:
Launch with:
docker compose up -d
| Variable | Default | Purpose |
|---|---|---|
OLLAMA_BASE_URL | http://host.docker.internal:11434 | Endpoint for the host's native Ollama runtime |
SOVEREIGNDOC_HOST | 0.0.0.0 | In-container bind address |
SOVEREIGNDOC_PORT | 8000 | In-container listening port |
ANONYMIZED_TELEMETRY | False | Disables telemetry across Chroma and backend libraries |
HF_HUB_OFFLINE | 1 | Forces HuggingFace hubs to stay strictly offline |
FASTEMBED_CACHE_PATH | /app/.cache/fastembed | Path for baked-in ONNX embedding model weights |
Persistent SQLite databases, Chroma vector vaults, and extracted document text are stored in /root/.sovereigndoc inside the container.
Mount a named volume or host directory:
-v sovereigndoc_data:/root/.sovereigndoc-v ${PWD}/data:/root/.sovereigndocContent type
Image
Digest
sha256:772e21cc0…
Size
509.2 MB
Last updated
about 23 hours ago
docker pull airgapaxis/sovereigndoc-backend