Quickstart

Get BitDrip running in under 5 minutes.

Prerequisites

• Docker 24+ with docker compose plugin or Podman 4+ with podman-compose
• A license file (license.jwt) — register free at bitdrip.app
• Linux or macOS host (Windows with WSL2 is supported)
• 2 GB RAM minimum, 4 GB disk

Steps

1. Register and download

Register at bitdrip.app. The Community tier is free — no credit card required.

After registering, check your email for:

• Your license.jwt file
• A download link for bitdrip-1.0.0.tar.gz

2. Extract the bundle

tar -xzf bitdrip-1.0.0.tar.gz
cd bitdrip-1.0.0

3. Place your license file

cp ~/Downloads/license.jwt ./license.jwt

4. Run the installer

bash install.sh

The installer detects your container runtime, validates the license, generates secure secrets, pulls images, and starts all services.

Expected output:

  ✓ Container runtime: docker (docker compose)
  ✓ License file found: ./license.jwt
  ✓ Environment configured
  ✓ Services started

  BitDrip is running
  ▸ Dashboard: http://localhost:3000
  ▸ API:       http://localhost:3001
  ▸ Gateway:   http://localhost:3002

5. Sign in to the dashboard

Open http://localhost:3000 and sign in with the admin credentials printed at the end of the installer output.

Next Steps

• Deploy the browser extension — protect your team's web AI use
• Configure compliance profiles — GDPR, HIPAA, PCI DSS, and custom rules
• Connect the API Gateway — protect programmatic AI calls
• Invite your team