Troubleshooting Guide

Docker: "permission denied while trying to connect"

This happens on Linux if your user isn't in the `docker` group.

sudo usermod -aG docker $USER && newgrp docker

Run this command and try again.

"API Key Invalid" or 401 Error

Ensure you copied the full key starting with `sk-ant-...`.

Check your balance at console.anthropic.com. You must have credits (not just a free tier account with $0 balance).

VNC Connection Refused (localhost:5900)

If the container is running but you can't connect:

  • Check if port 5900 is blocked by a firewall (especially on VPS).
  • Use the web interface at http://localhost:8080 instead.
  • Restart Docker Desktop.

Still stuck? Check GitHub Issues