Administration¶
fbadmin runs in one of two shapes:
- Desktop / local mode (default): one user, listening on
127.0.0.1, no login screen, like pgAdmin's desktop mode. Registered servers live in~/.fbadmin/servers.json(mode 0600). - Server mode: a shared installation (Docker, Kubernetes) with a login screen,
per-user server lists and encrypted saved passwords. Its setup is described in the
security guide (
docs/SECURITY.md), which is added to this section when the feature ships. Until then, only publish fbadmin on trusted networks.
| Page | Contents |
|---|---|
| Configuration | Environment variables, logging, request limits, driver choice, connection pool |
| Deployment | Docker image, Docker Compose, Helm chart, Kubernetes example with Firebird |
| Privacy | What fbadmin sends over the network (nothing, unless you opt in to the update check) |
Checklist for a shared installation¶
- Turn on server mode and set the admin and master passwords from a secret (the Helm
chart does this with
serverMode.enabled=true). - Put fbadmin behind HTTPS (an ingress or reverse proxy).
- Set
FBADMIN_RATE_LIMIT(requests per minute per client) and, behind a proxy,FBADMIN_RATE_LIMIT_TRUST_PROXY=1. - Use
--log-format jsonand ship the logs; every request is logged with its status and duration. - Keep the data directory on a persistent volume and back it up.
- Leave
FBADMIN_UPDATE_CHECK=offif the installation must not reach the internet.