Financial Freedom is an open source personal finance manager designed for users who want full control over their financial data. Built for privacy-conscious individuals, it eliminates reliance on cloud-based services like Mint or YNAB that monetize user data. It’s ideal for developers, tech-savvy households, and anyone seeking to break free from data-harvesting financial platforms.
The application is built with Laravel (PHP), Vue.js, Docker, MariaDB, Redis, and Meilisearch, enabling secure, self-hosted deployment on any system that supports containers—ranging from AWS and DigitalOcean to a Raspberry Pi. Its architecture prioritizes data ownership, with no third-party data sharing, and supports CSV imports for bank compatibility while planning future API integrations with Plaid and Finicity.
What You Get
- CSV Bank Import Support - Import transaction data from any bank that exports CSV files, enabling manual budget tracking without requiring API access.
- Self-Host Anywhere - Deploy on Docker-compatible systems including AWS, DigitalOcean, Synology NAS, or a Raspberry Pi, ensuring complete data ownership.
- Private Synchronization - Avoid third-party data brokers by keeping all financial data stored locally; no external servers process or store your transactions.
- Tagging and Splitting Transactions - Categorize and split expenses across multiple budget categories for granular financial tracking.
- Cash Flow and Budget Visualization - Monitor income and expenses over time with visual dashboards to identify spending patterns and stay on budget.
- Global Currency Support - Track and manage finances in multiple currencies, suitable for international users or those with foreign accounts.
Common Use Cases
- Running a private household budget - A family uses Financial Freedom to track expenses across multiple bank accounts without sharing data with Mint or YNAB, keeping all records on their home NAS.
- Managing freelance income and expenses - A freelancer imports bank CSVs to categorize client payments and business costs, ensuring accurate tax preparation without cloud dependency.
- Privacy-focused investors tracking net worth - An investor self-hosts Financial Freedom to monitor asset growth and spending habits without exposing financial data to commercial platforms.
- Tech-savvy users on a Raspberry Pi - A hobbyist runs Financial Freedom on a low-cost Raspberry Pi to maintain full control over financial data while avoiding subscription fees.
Under The Hood
Architecture
- Modular design using Laravel Modules to isolate domain logic into maintainable, reusable components
- Service layer pattern enforces clean separation of business logic from controllers, enhancing testability and scalability
- Inertia.js with Vue 3 enables server-side rendered SPAs with seamless state management and UI consistency
- Dependency injection and Laravel’s service container ensure loose coupling and easy dependency management
- Authentication and authorization are structured with Sanctum and middleware, with policies designed for future expansion
- Production infrastructure leverages Docker Swarm and Traefik with automated TLS and persistent storage for robust deployment
Tech Stack
- Laravel 10.x backend paired with Inertia.js and Vue 3 for dynamic, server-rendered user interfaces
- Frontend built with VueUse, HeadlessUI, and Heroicons, bundled via Vite 5 with Tailwind CSS for modern, responsive design
- Docker-based development and production environments with Traefik for dynamic routing, TLS termination, and service discovery
- Modular PHP architecture with Composer merge-plugin for unified dependency management across domains
- SQLite for local development, transitioning to volume-managed storage in production for scalability
- CI/CD pipelines and GitPod integration enable consistent, reproducible environments across development and deployment
Code Quality
- Comprehensive feature tests cover core authentication flows with reusable traits and factory patterns
- Clear directory organization and Laravel-conventional naming improve code readability and onboarding
- Strong type safety through PHP 8+ features and well-defined model relationships
- Limited static analysis or linting tooling, leaving room for automated quality enforcement
- Error handling relies on native Laravel mechanisms without custom exception classes
What Makes It Unique
- Native Meilisearch integration enables real-time, typo-tolerant search of personal financial data without external dependencies
- Event-driven category seeding on user registration personalizes the financial tracking experience from first login
- Document-driven content system with dynamic navigation transforms static guides into an interactive financial education platform
- Self-hosted architecture with Docker and Redis prioritizes user sovereignty over sensitive financial data
- Domain-focused service classes enforce single-responsibility principles within Laravel’s ecosystem, elevating maintainability