Household & spaces
Every financial space you belong to, with the controls your role allows: people, permission presets, invitations, ownership, and continuity. Day-to-day sharing, split expenses, allowances, and documents live in Spaces.
People
Sam Demo (you)[email protected]owner — full control
People
Sam Demo (you)[email protected]owner — full control
Legacy
Instance household
1 member
The legacy instance household seeds the shared household space. Prefer inviting people through the space cards above; use this only to add someone to the legacy household itself.
Members (1)
Sam Demo (you)[email protected]owner
Invite someone
Invitations expire after 14 days. Astroledger does not send email yet—share this app's address with them. They must sign in with the exact invited Google email. If
ALLOWED_EMAILS is configured, add them there too.Everyone in this self-hosted household shares the same ledger, plans, imports, and reports. Owners manage membership; members can use the financial workspace but cannot invite or remove people.
Account & security
Security
Passkeys (0)
None
No passkey enrolled. Enroll one now to sign in without Google.
Account
Reset demo
Drop your current sandbox and start fresh. Your edits will be lost.
Install
Get the app
PWA
Install Astroledger as a standalone app on this device. It opens in its own window, runs offline for the chrome (the data still needs a connection), and gets a homescreen icon. No app-store account required.
On a phone, use the full public URL Astroledger is reachable at (typically a Cloudflare Tunnel hostname - see
docs/CLOUDFLARE_TUNNEL.md) so the device can reach this server.Preferences
Alerts
Dismissed-alert retention
Default 12 days
Dismissed recommendations in Insights stay restorable for this many days, then delete automatically.
Accounts
Hide inactive accounts
12m
Accounts with no transactions for this many months are auto-hidden from the Accounts page, the account picker, and rollup totals - they stay in the database and reappear immediately if a fresh transaction lands. Set to
0 to disable.months of inactivity
Theme
Appearance
Theme, information density, and privacy mode live in the top bar so they stay available everywhere. Device installation and account preferences stay on this page.
Organization
Organization
Tags
Parent > Child
Two-level hierarchy. Primary tags render as filled pills; secondary tags render as outlined chips. Either level can be attached to transactions or subscriptions. Edits autosave.
2 tags · 1 parents · 1 children
Automation
Categorization rules
Auto-applied
Rules auto-apply on every transaction insert across all import paths (CSV, QIF, SimpleFIN, Plaid, PayPal, PDF, manual). Substring or regex match against rawDescription or merchant. Apply tags, category, isTransfer flag, or rename the merchant. Lower sortOrder runs first; on a category/merchant conflict, highest sortOrder wins.
No rules yet. Create one to auto-tag or auto-categorize matching transactions.
Automation · learned
Suggested rules
From your edits
Scanning your categorizations…
Foreign currency
FX rates
USD base
Base currency: USD. Rates are stored as
1 USD = rate × quote. Astroledger looks up the most recent rate at or before each foreign-currency charge date.Automation & AI
Automation
Gmail auto-sync
LLM-assisted
Periodically scan your inbox for new receipts, capped per run for rate-limit safety. When the configured model is reachable, new receipts are classified and recurring charges surface under Insights.
Loading…
AI
LLM provider
Pluggable
Pick the model that powers Spacer chat and LLM-assisted auto-categorization. Works with Ollama (local), OpenAI, Anthropic, or any OpenAI-compatible endpoint. API keys are stored as env-var names only — the key value never enters the database. Use Test connection before saving.
Loading…
Data & safety
Data
Export your data
Leave anytime
Download your visible financial history in open formats. Exports respect per-account export permissions in the active space.
CSV — every transaction + tags/category/flags, opens in any spreadsheet. QIF — multi-account Quicken format (round-trips back into Astroledger or any QIF-aware app). JSON — complete denormalized dump of every table (accounts, transactions, budgets, goals, rules, holdings, etc.) for archival or migration. Connector credentials are excluded.
Hygiene
De-duplication
Idempotent
- Tags - merges root tags with the same name (case-insensitive). The older row wins; children, transactions, and subscriptions move over.
- Subscriptions - merges near-duplicates for the same merchant (cadence within ±4 days, amount within 15%). Transactions get re-pointed and tags are unioned onto the surviving subscription.
- Transactions - flags cross-account duplicates (same merchant + day + amount) as transfers so rollups stop double-counting. The bank-side charge is preserved; the wallet/ecommerce side is hidden from totals.
Updates
Software updates
GitHub releases
Checking for updates…
Automation
Database backups
Encrypted at rest
Snapshots are created in memory-backed scratch space, compressed, and wrapped in an authenticated AES-256-GCM envelope under the dedicated backup key. Restores verify the envelope and database integrity before touching the live database.
Loading…
Data
Local-first
Astroledger keeps its database and uploads on this server. The full database is encrypted at rest, credentials carry a second field-encryption layer, and receipt/document files use authenticated file envelopes. Keys are mounted from root-managed files, never stored in Docker metadata.