hledger web reports

A read-only financial app for an hledger journal. Browse saved reports and account activity, or explicitly request preparation and live queries. Hledger owns accounting.

Run locally

Use Docker with host networking enabled. Create private apps/web/config/hledger-reports.yaml from the example, without overwriting existing configuration. Select your journal and supply the sign-in secrets.

The worker mounts apps/web/journals/, or JOURNAL_DIR, read-only at /journal. Use that container path in the configuration.

cd apps/web &&
mkdir -m 700 -p data &&
docker compose -f docker-compose.dev.yml up --build --wait

Open http://localhost:5173/, sign in and choose Prepare reports in Settings. Reload for status. Browsing and journal edits never prepare reports automatically.

Keep configuration, journals and the shared data folder private and backed up.

Guides

• Development and operations
• Configuration
• Authentication
• Architecture
• Development principles