Troubleshooting & FAQ

Common Errors

License file not found at './license.jwt'

Your license file is missing from the installation directory.

Fix: Download license.jwt from your welcome email and place it in the same directory as install.sh:

cp ~/Downloads/license.jwt ./license.jwt
bash install.sh

---

Dashboard loads but shows "Cannot connect to API"

The Dashboard can't reach the Policy Engine.

Check service status:

docker compose ps
docker compose logs policy-engine

Look for startup errors. Verify API_URL in .env matches the Policy Engine port (default: 3001).

---

Browser extension shows red icon

The extension cannot reach your Policy Engine.

Verify BitDrip is running:

docker compose ps
curl http://localhost:3001/health

If running on a different host or port, update: Extension popup → Settings → Policy Engine URL.

---

port XXXX is already in use

Another service is using port 3000, 3001, or 3002.

Fix: Edit the port mappings in .env, then restart:

docker compose down && docker compose up -d

---

Forgot admin password

docker compose exec policy-engine node dist/scripts/reset-admin.js

Follow the prompts to set a new password.

---

no space left on device

Docker images and volumes have filled your disk.

docker system prune        # remove unused images/containers
docker volume prune        # remove unused volumes (careful: may delete data)

---

Diagnostic Commands

# View all service logs
docker compose logs -f

# Check specific service
docker compose logs -f policy-engine

# Health check
curl -s http://localhost:3001/health | python3 -m json.tool

# Restart a service
docker compose restart policy-engine

# Resource usage
docker stats $(docker compose ps -q)

---

FAQ

Does BitDrip send any data to Anchor Cyber Security?

The running product sends only a license validation signal to portal.bitdrip.app — a hash of your installation ID and license ID. No conversation content, prompts, user data, or policy configurations are ever transmitted.

---

Can I run BitDrip without internet access?

Yes. The Policy Engine operates fully offline. License validation requires internet access on first start; after that, a 7-day grace period applies if connectivity is lost.

---

What AI services does the browser extension support?

ChatGPT (chat.openai.com), Claude (claude.ai), Gemini (gemini.google.com), and Copilot (copilot.microsoft.com) are supported by default. Additional services can be added via custom URL patterns in Admin Dashboard → Policies → Extension Sites.

---

Does BitDrip support Safari?

No. Chrome, Firefox, and Edge are supported.

---

How do I update BitDrip?

Download the new bundle from portal.bitdrip.app after signing in. Copy your license.jwt and .env into the new directory, then run install.sh.

---

How many users can I have?

Community: 10 · Starter: 50 · Professional: 250 · Enterprise: unlimited. See bitdrip.app for pricing.

---

How do I get support?

Email contact@anchorcybersecurity.com with your BitDrip version (docker compose exec policy-engine node -e "console.log(require('./package.json').version)") and a description of the issue.