Get started Bouncer overview Read offline Manual for Bouncer 0.5.7. Chapters state version and distribution limits. Source cdd3b59, site build 20 November 2026. Your server or app may run an earlier version.
Browse all chapters
On this page
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
~/bouncerThe 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.yaml0644 The config file
/etc/bouncer/config/openbao-ca.pem0644 OpenBao's CA, if needed
/etc/bouncer/secrets/0700, user 10001 The secret files
/etc/bouncer/secrets/bouncer-role-id0400, user 10001 OpenBao AppRole role_id
/etc/bouncer/secrets/bouncer-secret-id0400, user 10001 OpenBao AppRole secret_id
/etc/bouncer/secrets/bouncer-db-password0400, user 10001 The database password
/etc/bouncer/secrets/bouncer-ssh-role-id0400, user 10001 SSH signer AppRole role_id, if SSH is on (compose.ssh.yaml)
/etc/bouncer/secrets/bouncer-ssh-secret-id0400, user 10001 SSH signer AppRole secret_id, if SSH is on
/etc/bouncer/secrets/fcm-service-account-2.json0400, user 10001 Second Firebase key while moving projects (compose.push2.yaml)
/etc/bouncer/secrets/fcm-service-account.json0400, user 10001 Firebase key, if push is on
/var/backups/bouncer/0700 Daily backups from the timer
/usr/local/libexec/bouncer-backup0755 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.sockThe 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_pgdataPostgreSQL's data. docker compose down -v deletes it
bouncer_pg-socketPostgreSQL's socket, a small in-memory volume
bouncer_bouncer-runThe admin socket
Path Mode What
~/.local/bin/bouncer, ~/.local/bin/bouncer-mcp0755 The binaries (or /usr/local/bin, or /usr/bin from a package)
~/.config/bouncer/0700 Settings folder
~/.config/bouncer/serverThe server's address
~/.config/bouncer/key0600 The requester key
%LOCALAPPDATA%\bouncer\server, %LOCALAPPDATA%\bouncer\keyprivate to the Windows account Windows CLI settings and encrypted key
Path What
deploy/openbao-role-kit/resourcesYour list of secrets. Keep it, in your own repository; the emergency stop needs it
deploy/openbao-role-kit/kit.envYour 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.
Get started Bouncer overview Read offline