dig data logodig data

DOCKER SETUP · v0.1.0-beta.12

Start dig data on your own infrastructure.

Run one container. Your team uses dig data through a browser.

Try it locally

  1. Install Docker Engine or Docker Desktop.
  2. Run docker volume create dig-data.
  3. Start dig with docker run -d --name dig --restart unless-stopped -p 127.0.0.1:8080:8080 -v dig-data:/data --add-host=host.docker.internal:host-gateway hesham099/dig-data:v0.1.0-beta.12.
  4. Open http://127.0.0.1:8080 and create the first administrator.
  5. Add your Anthropic or OpenAI API key and a PostgreSQL, MySQL, MariaDB, or MongoDB source with read-only credentials.

Deploy for a company

  1. Use the Compose configuration on the home page and run docker compose up -d.
  2. Keep the published port on 127.0.0.1:8080 and provide access through your company VPN.
  3. Set DIG_PUBLIC_URL to the HTTPS address employees use and place dig behind your existing HTTPS reverse proxy.
  4. Grant each teammate only the database sources they need.
  5. Allow outbound access to Anthropic and the configured databases.

AI and company data

For a data question, dig may send relevant schema details, your question, and bounded query results to the administrator-selected Anthropic or OpenAI API. Self-hosting keeps dig data accounts and dashboards on your volume, but it does not keep every AI interaction inside your company.

Database connections

The container includes a host.docker.internal host mapping. Use that hostname instead of localhost when connecting to a database on the Docker host. Create a dedicated read-only account for PostgreSQL, MySQL, MariaDB, or MongoDB, limited to approved schemas, tables, or collections.

Back up and restore

Stop dig before a consistent backup: docker stop dig. Back up the dig-data volume, then restart with docker start dig. The volume contains credentials, settings, dashboards, and audit records.

Upgrade

  1. Back up dig-data.
  2. Change the pinned image tag in Compose.
  3. Run docker compose pull, then docker compose up -d.
  4. Confirm http://127.0.0.1:8080/health returns an OK response.