| Port | Where | What |
| 443 | Your HTTPS front end | What apps and requesters connect to (instance.url) |
| 8080 | 127.0.0.1 on the server | The Bouncer server's plain HTTP listener. Change with BOUNCER_PORT |
| 8200 | OpenBao | OpenBao's API. The deploy/openbao kit listens on 127.0.0.1:8200 and puts HTTPS in front, on 8443 in its README |
| none | | PostgreSQL has no network; the server uses its Unix socket |
| none | | The admin API is a Unix socket only |
Outbound from the server: OpenBao, and Firebase (Google, port 443) if push is on.
These modes are set by the install instructions. The requester key's mode is checked by code; the other modes are deployment requirements.
| Path | Mode and owner | What |
~/bouncer | | The repository checkout. Nothing secret |
/opt/bouncer/releases/<full commit> | | With ship.sh: that commit's deploy/ folder only. Nothing secret |
~/bouncer/deploy/compose/.env (or /opt/bouncer/releases/<full commit>/deploy/compose/.env) | | Compose settings. Nothing secret |
/etc/bouncer/config/bouncer.yaml | 0644 | The config file |
/etc/bouncer/config/openbao-ca.pem | 0644 | OpenBao's CA, if needed |
/etc/bouncer/secrets/ | 0700, user 10001 | The secret files |
/etc/bouncer/secrets/bouncer-role-id | 0400, user 10001 | OpenBao AppRole role_id |
/etc/bouncer/secrets/bouncer-secret-id | 0400, user 10001 | OpenBao AppRole secret_id |
/etc/bouncer/secrets/bouncer-db-password | 0400, user 10001 | The database password |
/etc/bouncer/secrets/bouncer-ssh-role-id | 0400, user 10001 | SSH signer AppRole role_id, if SSH is on (compose.ssh.yaml) |
/etc/bouncer/secrets/bouncer-ssh-secret-id | 0400, user 10001 | SSH signer AppRole secret_id, if SSH is on |
/etc/bouncer/secrets/fcm-service-account-2.json | 0400, user 10001 | Second Firebase key while moving projects (compose.push2.yaml) |
/etc/bouncer/secrets/fcm-service-account.json | 0400, user 10001 | Firebase key, if push is on |
/var/backups/bouncer/ | 0700 | Daily backups from the timer |
/usr/local/libexec/bouncer-backup | 0755 | backup.sh, installed for the timer |
/etc/systemd/system/bouncer-logical-backup.{service,timer} | 0644 | The backup timer |
| Path | What |
/etc/bouncer/ | The config folder, read-only |
/run/secrets/<name> | The secret files, read-only |
/run/bouncer/admin.sock | The admin socket, mode 0600, on the bouncer-run volume |
/run/postgresql/ | PostgreSQL's socket, read-only, on the pg-socket volume |
The container's root filesystem is read-only, it has no Linux capabilities, and it runs as user 10001.
| Volume | What |
bouncer_pgdata | PostgreSQL's data. docker compose down -v deletes it |
bouncer_pg-socket | PostgreSQL's socket, a small in-memory volume |
bouncer_bouncer-run | The admin socket |
| Path | Mode | What |
~/.local/bin/bouncer, ~/.local/bin/bouncer-mcp | 0755 | The binaries (or /usr/local/bin, or /usr/bin from a package) |
~/.config/bouncer/ | 0700 | Settings folder |
~/.config/bouncer/server | | The server's address |
~/.config/bouncer/key | 0600 | The requester key |
%LOCALAPPDATA%\bouncer\server, %LOCALAPPDATA%\bouncer\key | private to the Windows account | Windows CLI settings and encrypted key |
| Path | What |
deploy/openbao-role-kit/resources | Your list of secrets. Keep it, in your own repository; the emergency stop needs it |
deploy/openbao-role-kit/kit.env | Your kit settings, if you changed any |
deploy/openbao-role-kit/rendered/ | Policies the kit rendered |
All three are ignored by Git in the Bouncer repository.