Storage Backends
webAgent keeps all its data in a database, and you choose which kind. The default needs
zero setup — a simple local file-based store — so the app just works out of the box.
When you outgrow that, you can switch without changing how the app behaves.
Options for the main application data:
- Local file store (default) — nothing to configure; great for a single machine.
- Postgres-family — full Postgres, plus hosted flavours (e.g. Neon, Google Cloud
SQL). These are fully supported live backends: click Activate and the running app
switches over. A built-in tool copies your existing data across.
- Supabase and MySQL are also supported (MySQL for setup/testing).
You manage all of this in the Storage panel (App Config → Storage), which also has
buttons to view the schema and auto-create tables, and to export/import your data as
a file for migration or backup.
A few data stores stay separate by design and are always local files regardless of the
main backend: the Wiki, the diagnostic logs, and the credentials
vault — so logs never slow down user data, and the wiki stays portable.
Related: Secrets & Encryption, App Config Overview.