Self-hosting guide

Run the Driftbase server and (optionally) the API in your own network. Data never leaves your infrastructure.

Docker

Use the official image and mount a volume for persistence:

docker run -d \
  -p 8080:8080 \
  -v driftbase_data:/data \
  -e DRIFTBASE_DB_PATH=/data/driftbase.db \
  driftbase/server:latest

Environment variables

• DRIFTBASE_DB_PATH — Path to SQLite DB (default: local file).
• DRIFTBASE_PORT — HTTP port (default: 8080).
• DRIFTBASE_LOG_LEVEL — debug | info | warn (default: info).

For production, point DRIFTBASE_DB_PATH to a persistent volume. You can also use an external Postgres URL when supported; see the image docs.

Database

By default the server uses SQLite. Ensure the mounted volume has write permissions. For high throughput, we recommend a dedicated Postgres instance (configuration TBD in a later release).

Networking

Clients (SDK or proxy) should reach the server on your internal network. No outbound calls to Driftbase cloud are made when self-hosted.