headroom
Self-hosted personal finance tracker for budgets, assets, investments, and loan modeling with Dockerized SQLite storage.
Ficha actualizada 23 sept 2026, 1:57 · upstream 23 sept 2026, 1:33 · release v3.6.0
Qué es headroom
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Headroom is a self-hosted personal finance tracking application that allows users to manage monthly budgets, track expenses, monitor asset growth, model housing loans, and receive smart spending recommendations. The application runs entirely on the user's machine using Docker for containerization and local SQLite databases, with no cloud storage or account required. Norwegian language support is natively included. The app features a live dashboard showing total equity, budget health, asset allocation, and a running net worth chart. It supports multiple currencies including Norwegian Krone (NOK), US Dollars (USD), and any custom currency.
- Track monthly budgets with variable income support
- Monitor investment portfolio growth over time
- Model housing loans with amortization schedules
- Plan personal finances without using a cloud service
- Set up automated budgeting for recurring expenses
- Runs entirely locally on the user's machine with no data sent to any server or cloud provider
- Supports Norwegian language natively alongside English
- Includes loan calculator with first-time buyer, homeowner, and buy-and-sell scenarios
- Features a live dashboard showing budget health, asset allocation, and net worth trends
- Automatically adapts the spend/invest split based on historical income patterns
- No login or authentication — all data is stored locally on the user's machine
- Data persistence requires manual backup via Docker volume mounts or the app's export feature
- Limited to a single user per instance (no multi-tenant features)
- No real-time transaction notifications or mobile app support
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Run Headroom using Docker Desktop on macOS, Windows, or Linux. The container exposes port 8080 for the frontend and 3001 for the API. Use `--restart unless-stopped` to keep the service running after reboots. For production use, consider a reverse proxy (e.g., Nginx) in front of the Docker container to handle SSL/TLS termination or load balancing. Always back up your SQLite database before updates by running `make backup`. The app is built with Node.js 24 and React, using Vite for development and production builds.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.