Your finances. Your data. Your control.
An open-source personal finance app for tracking spending, planning budgets, and keeping your accounts in one place. Run it on your own server or try the Windows desktop preview.
Get started · Features · Themes · User manual
Choose how you want to use HomeLedger:
| Where | Get started | Status |
|---|---|---|
| Your server, NAS or homelab | Install with Docker | Recommended for production |
| Your Windows PC | Download the Windows x64 installer | Unsigned preview; use synthetic data for testing |
| Home Assistant | Install the add-on or connect an existing instance | Add-on + HACS integration |
The desktop preview needs no separate server or Docker. See its guide and limitations; macOS/Linux installer validation is pending.
Your support helps sustain development and maintenance.
- See your finances together. Track bank accounts, credit cards, cash, investments and net worth.
- Keep spending organized. Record income and expenses, transfer money between accounts, import bank files and categorize transactions with rules.
- Plan ahead. Set budgets and savings goals, manage loans, and track subscriptions and upcoming payments.
- Understand your money. Explore cash flow, spending categories and trends through reports and alerts.
- Keep the paperwork. Attach receipts and invoices, extract their details, and export or back up your data.
- Connect your tools. Use Home Assistant, the REST API, or the optional MCP integration for AI assistants.
Accounts can use different currencies with manually maintained exchange rates. MCP is off by default and requires user confirmation before enabling.
Explore the user manual · Full feature and technical reference
Normal, shown above, offers light and dark modes. Cyberpunk 2077, shown below, uses a burgundy background, electric yellow headers and cyan accents. Both themes use the same data and financial workflows, with responsive layouts.
Switch in Settings → Profile → Interface design. Your choice is saved in your browser, and your Normal light/dark preference is preserved when switching themes.
View the screenshot gallery · Create a theme
Screenshots use synthetic demo data. The Cyberpunk theme is an unofficial visual inspiration; HomeLedger is not affiliated with CD PROJEKT RED.
Choose your language in Settings → Profile.
| Language | Locale | Credit |
|---|---|---|
| English | en |
Original project language |
| Spanish (Español) | es |
Original project language |
| Brazilian Portuguese (Português do Brasil) | pt-BR |
Thiago Alves (@ThiaAlves), PR #20 |
Languages are modular packs shared across web, backend and desktop. Contribute a translation.
| I want to… | Go to |
|---|---|
| Install or configure HomeLedger | Installation · Environment variables |
| Learn the app | User manual · Manual en español |
| Upgrade or recover access | Upgrading · Account recovery |
| Configure HTTPS or backups | Deployment and operations |
| Connect Home Assistant | Add-on and integration guide |
| Build an integration | API reference · MCP guide |
| Report a problem or suggest a feature | Open an issue |
Bug reports, translations, documentation and code contributions are welcome. Start with the contributing guide, explore the roadmap, or read the changelog.
HomeLedger is built with SvelteKit, Fastify, TypeScript and SQLite. Development setup · Theme contributions
Please follow our Code of Conduct. Report vulnerabilities through the Security Policy.
HomeLedger is built and maintained in spare time and will remain free. Sponsoring or buying a coffee helps keep the project going. Starring the repository, reporting bugs and helping other users also make a difference.