Files
brokeless/docker
MangaValkandClaude Opus 5.5 0232766260 Connect my computer: works from Docker and on Windows
- Docker passes BROKE_HOSTED through (setting it in .env did nothing before)
- the helper finds claude.exe / claude.cmd on Windows (PATH uses ';' there),
  runs a .cmd through cmd.exe with the question on stdin only, and keeps the
  Windows variables Claude needs to find its login; opencode on Windows only as .exe
- the page gives Windows a PowerShell command (curl.exe, file then node)
- Copy works on a plain http LAN address

Tested on Windows end to end with a stand-in claude.cmd: pairing, a question with
quotes, & and %, and every lockdown flag arriving intact.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 20:50:41 +01:00
..
2026-11-17 13:56:32 +01:00
2026-11-17 15:00:24 +01:00

brokeless in Docker

Everything runs here: the app, its Postgres database, sign-in and the REST API (the parts of Supabase it uses), a mail catcher for sign-in links, and optionally Ollama for AI. No Supabase cloud, no Vercel, no auto-update.

Container What it does Port
gateway nginx: broke plus /auth/v1 and /rest/v1 on one address HTTP_PORT (3003)
broke the app, built from this checkout inside only
db Supabase's Postgres image inside only
auth Supabase Auth (GoTrue): email sign-in links inside only
rest PostgREST: the database API, row-level security applies inside only
mailpit catches sign-in emails, behind a password MAIL_UI_PORT (8025)
ollama local AI, only with --profile ai inside only

First start

  1. Pick the address you will open broke on, for example http://192.168.1.10:3003 (your Unraid IP; not localhost, the containers need to reach it too). Then make the secrets:

    node docker/setup.mjs --url http://192.168.1.10:3003
    

    No Node on the server:

    docker run --rm -v "$PWD":/w -w /w node:22-alpine node docker/setup.mjs --url http://192.168.1.10:3003
    

    On Unraid, edit docker/.env and set DATA_DIR=/mnt/user/appdata/brokeless.

  2. Start it:

    docker compose -f docker/docker-compose.yml up -d --build
    

    With local AI as well: add --profile ai, then pull a model, for example docker exec brokeless-ollama-1 ollama pull qwen3:8b.

  3. Open your address, type your email, then open Mailpit on port 8025 (user broke, password MAIL_PASSWORD in docker/.env) and click the link.

  4. Lock it to you: set DISABLE_SIGNUP=true in docker/.env, then run up -d again.

  5. Add your bank: Accounts, Add accounts, import a statement. For ING, download your transactions from Mijn ING as CSV (comma or semicolon both work).

Unraid

Install the Compose Manager plugin, add a stack, and point it at this folder's docker-compose.yml, or run the commands above over SSH from the repo folder. Keep the port on your LAN or behind Tailscale. Don't forward it on your router.

Good to know

  • PUBLIC_URL is built into the app. If your server's address changes, update .env and run up -d --build.
  • broke's server reaches Supabase through PUBLIC_URL as well, so the server must be able to reach its own address (it can on Unraid).
  • Back up DATA_DIR/db and docker/.env together. The database is useless without the secrets in .env.
  • Database changes in supabase/migrations apply each time broke starts.

Updating

Nothing updates by itself. See Update in the main README for pulling your own changes and reviewing upstream ones.

docker/db/*.sql come from Supabase's self-hosting setup (Apache-2.0).