Where your data lives
When you run Ember locally, Docker sets up PostgreSQL to store your work and Redis to manage the job queue. You do not need to install these separately.
| Component | Purpose | Managed local storage |
|---|---|---|
| PostgreSQL 16 | Accounts, cohorts, document content/metadata, prompts, processing records, results, and encrypted connection secrets | Persistent Docker volume cli-db (normally ember-cli_cli-db) |
| Redis 7 | Celery job queue and worker coordination | Persistent Docker volume cli-redis (normally ember-cli_cli-redis) |
| API, workers, scheduler | Save your work, schedule jobs, and send documents to your model | Local Docker services; LLM calls go to your configured endpoint |
| CLI configuration | API-scoped login tokens, deployment settings, and resumable workspace checkpoints | ~/.ember/, or the directory set by EMBER_HOME |
| Exported results | CSV, Excel, JSON, and recovery manifest/bundle | The output directory you choose |
The managed local API binds to 127.0.0.1:18081; PostgreSQL and Redis expose no host ports. Stopping/restarting services retains named volumes. Deleting volumes deletes their stored data; exports are not a full database backup. Preserve the deployment encryption key together with database backups so saved connection secrets remain usable.
With an existing API, the database and queue live with that deployment; the CLI still stores its local settings and downloaded exports on your machine. Your institution’s rules still apply to storage, access, and sending documents to remote services.
Optional terminology indices
The public image does not include ICD-10-GM or OPS datasets. Extraction still works; local terminology lookup remains unavailable until you supply licensed indices. To enable it, mount your institution’s icd-10-gm.json and ops.json index directory read-only at /packages/bf-terminology/data/terminology in the API and worker containers. Restart these services after changing indices. Keep the files outside Git and follow your source provider’s redistribution terms.