Firefly III

Self-hosted personal finance, honestly reviewed. No marketing copy, just what you get when you run it on your own server.

TL;DR

• What it is: Open-source (AGPL-3.0) personal finance manager — think YNAB, but the source code lives on your server and nobody can raise your subscription price [README][1].
• Who it’s for: Privacy-conscious individuals, multi-currency households, and self-hosters who want serious bookkeeping without recurring SaaS fees. Accountants and spreadsheet-heads who want double-entry discipline will feel at home [2][6].
• Cost savings: YNAB charges around $109/year. Mint, the legacy free alternative, shut down in January 2024. Firefly III self-hosted runs on a $5–10/mo VPS with no per-user or per-account fees [1].
• Key strength: Genuinely comprehensive — double-entry bookkeeping, rule engine, piggy banks, multi-currency, recurring transactions, and a REST API. The feature depth is closer to desktop accounting software than a budgeting app [README][6].
• Key weakness: The setup is not for non-technical users — you’re installing PHP, a database, Redis, and a separate data importer tool. The maintainer is opinionated and has declined several common feature requests (notably subcategories). A handful of AlternativeTo reviewers report post-installation database issues [5].

---

What is Firefly III

Firefly III is a self-hosted web application for tracking personal finances. You log every transaction — income, expense, transfer — and the software builds reports, enforces budgets, and tracks savings goals. The developer’s stated purpose is direct: “if you know where your money is going, you can stop it from going there” [README].

What separates it from a spreadsheet or a cloud budgeting app is a few concrete decisions. First, it uses double-entry bookkeeping — every transaction moves money between two accounts, which means the books always balance and you can audit exactly where every dollar went [README][6]. Second, it is completely air-gapped from external servers unless you explicitly configure otherwise — no background sync, no telemetry, no bank scraping by default [README]. Third, it has a rule engine that lets you auto-categorize transactions based on patterns (useful for cleaning up the garbage descriptions that come out of bank CSV exports) [README][6].

The project is maintained primarily by one developer (James Cole, Netherlands) and has accumulated 22,683 GitHub stars over roughly a decade of development. It has a companion tool — the Firefly III Data Importer — which handles pulling transactions from banks via CSV, OFX, or open banking APIs. That importer is a separate application, not bundled into the main install.

The license is AGPL-3.0. For personal self-hosting, this doesn’t change anything — you install it, you use it, you own your data. The AGPL clause only matters if you distribute a modified version to others.

---

Why people choose it

Reviews cluster around three core motivations: privacy, cost, and flexibility that cloud tools don’t offer.

Privacy over convenience. The XDA Developers review [1] frames this clearly: cloud budgeting apps connect to your bank, store your transaction history on their servers, and monetize through advertising or data partnerships. Firefly III runs on your hardware. The author writes that he “refuses to grant third parties access to his savings, subscriptions, loans, and other financial transactions” — and Firefly III is the tool that made that stance practical. The oddwired.com author [2] comes at this from a different angle: he moved from counter books to Google Sheets to self-hosted, and the main pull was owning data he’d built up over years of meticulous tracking.

Escaping subscription pricing. YNAB is ~$109/year. Mint is dead. PocketGuard has a free tier with a paid upgrade. Firefly III is permanently free. The XDA review [1] names this as the first reason to switch: “Firefly III doesn’t have a pricing structure, meaning I don’t have to spend more money just to manage my finances.” For a tool you use every day for years, that math compounds.

Flexibility that zero-sum budgeting doesn’t allow. YNAB enforces “give every dollar a job” — you pre-allocate your entire income at the start of each month. The XDA reviewer [1] explicitly dislikes this model and calls out Firefly III’s alternative: a piggy bank system where surplus money gets set aside toward a goal rather than pre-committed to a category. This is a real design difference, not just a cosmetic preference. If zero-sum budgeting fits your style, YNAB is better. If you want to track what you spend and set savings goals without micro-managing every dollar before the month starts, Firefly III’s model is more comfortable [1].

Household and multi-currency use cases. The XDA review [1] highlights that YNAB restricts account access per subscription, while Firefly III allows unlimited user profiles. For shared household tracking — splitting expenses between partners or family members — this matters. Similarly, YNAB only supports a single currency per budget; Firefly III handles multiple currencies natively, with exchange rates and cross-currency reporting [1][6].

The negative side from the reviews is equally consistent: setup is genuinely hard for non-technical users [5], the maintainer declines feature requests that many users want (subcategories being the most-cited example [5]), and at least one reviewer had post-installation database corruption that forced them to abandon the tool [5].

---

Features

From the README, website, and first-hand descriptions:

Core transaction management:

• Double-entry bookkeeping — every transaction has a source and destination account [README][6]
• Create and tag transactions; bulk editing via rules [README]
• Recurring transactions with flexible schedules [README]
• Rule engine — pattern-match on description, amount, payee, then auto-apply category/budget/tag [README][6]
• Multiple account types: asset, savings, shared/household, credit card, cash, external [6]

Budgeting and goals:

• Budgets with configurable limits per period, in multiple currencies [README][1]
• Piggy banks — named savings goals you move money into incrementally [README][1]
• Categories and tags — you can use either or both; not mutually exclusive [1]
• No forced zero-sum allocation — surplus is yours to place where you want [1]

Reporting:

• Income and expense reports by week, month, year [README][6]
• Budget compliance reports [6]
• Account audit views (detailed list, not just summary) [homepage]
• Category and tag comparison [homepage]
• Charts throughout the UI [6]

Data import:

• Separate Data Importer application handles CSV, OFX/QFX, and open banking [README][6]
• Rule engine can transform and clean up import data automatically [README]
• Manual transaction entry with autocomplete [README]

Technical:

• REST JSON API covering most application features [README][homepage][6]
• 2FA support [README][6]
• Multi-currency including crypto (BTC, ETH) [README][6]
• Docker image available; Kubernetes and YunoHost support listed [merged profile]
• Self-contained — no external server calls unless you configure them [README]

What’s missing or weak:

• No subcategories — this is a documented decision by the maintainer that has frustrated multiple users [5]
• Budget refund handling is incomplete — refunds don’t correctly offset budgets [5]
• Some reports are considered by users to present data in non-useful formats [5]
• No built-in bank sync — you either import CSV manually or configure the separate importer [README]

---

Pricing: SaaS vs self-hosted math

Firefly III self-hosted:

• Software: $0 (AGPL-3.0)
• VPS to run it: $5–10/month on Hetzner, Contabo, or DigitalOcean
• Unlimited users, unlimited accounts, unlimited transactions

YNAB (the closest real competitor):

• $14.99/month or $109/year
• 34-day free trial
• One currency per budget; account access tied to subscription

Mint:

• Shut down January 2024. Not an option anymore [3].

Actual Budget (the other self-hosted contender):

• Self-hosted version: free
• Managed cloud: $15/month

Concrete savings over 3 years:

Tool	Year 1	Year 2	Year 3	Total
YNAB	$109	$109	$109	$327
Actual Budget Cloud	$180	$180	$180	$540
Firefly III self-hosted	$60 (VPS)	$60	$60	$180
Firefly III local-only	$0	$0	$0	$0

The self-hosted VPS cost assumes a basic $5/month instance — shared with other services it costs less. If you’re already running a home server or a NAS, the incremental cost is close to zero.

The YNAB number is charitable: if YNAB raises its price (it has before), year-over-year cost climbs. Firefly III’s cost does not.

---

Deployment reality check

This is where the honest gap between Firefly III and cloud tools shows up. The README’s install path is Docker Compose, which is manageable but not trivial. The oddwired.com reviewer [2] calls Docker installation “straightforward” — that assessment assumes familiarity with Docker.

What you actually need:

• A Linux VPS or home server with at least 1GB RAM (2GB+ if running other containers)
• Docker and docker-compose
• A database (MySQL or PostgreSQL — bundled in the default compose file)
• Redis (bundled)
• A domain and reverse proxy (Caddy or nginx) for HTTPS
• An SMTP provider if you want email notifications or password resets
• The separate Data Importer application if you want to pull bank data in bulk

What can go sideways:

• One AlternativeTo reviewer [5] spent hours on installation, got it working, then had database access issues two weeks later and gave up entirely. This is an uncommon outcome but not an isolated report.
• The Data Importer is a separate Docker service with its own configuration. Many first-time users don’t realize it’s not included in the main install.
• CSV import requires specific formatting — the rule for cleaning up malformed descriptions exists precisely because bank CSV exports are often garbage [README].
• The AlternativeTo reviewer who complained about subcategories [5] notes that GitHub Issues and Discussions show the maintainer actively closing requests for features he considers out-of-scope. If you need the tool to work a specific way and that way conflicts with the maintainer’s design philosophy, you’re writing a fork or moving on.

Realistic time estimate for a technical user comfortable with Docker: 1–2 hours to a working instance. For someone who has deployed one or two Docker stacks before: 2–4 hours including domain and SMTP. For a non-technical user following a step-by-step guide: a full afternoon, possibly more if database or networking issues arise. For someone who has never touched a Linux server: hire someone or use Actual Budget’s cloud version instead.

---

Pros and cons

Pros

• Permanently free. No trial period, no feature tiers, no per-user pricing. Install it and use it indefinitely [1][README].
• Complete data ownership. Your financial history lives on your hardware. No third-party scraping, no advertising, no vendor lock-in [1][2][README].
• Double-entry bookkeeping. If you’ve ever used actual accounting software, you’ll appreciate that the books always balance. This is rare in consumer budgeting apps [README][6].
• Rule engine. Auto-tagging and auto-categorizing transactions from import files makes cleanup painless once the rules are configured [README][6].
• Multi-currency done properly. Multiple currencies across multiple accounts with exchange rate support — YNAB doesn’t offer this at all [1][6].
• Unlimited users. Household tracking with separate accounts for each person costs nothing extra [1].
• REST API. You can build scripts, integrations, or mobile apps on top of it. The API covers most of Firefly III’s functionality [README][homepage][6].
• 22,683 GitHub stars. This is a mature, actively maintained project with a decade of history behind it [merged profile].
• No zero-sum enforcement. If YNAB’s budgeting model doesn’t fit your style, Firefly III’s flexible approach is a genuine alternative [1].

Cons

• Non-trivial installation. Docker + database + Redis + separate importer + reverse proxy. Not a one-click install. AlternativeTo reviews document multiple cases of setup failure [5].
• No subcategories. This is the most-cited missing feature and the maintainer has explicitly declined to add it [5]. Workarounds exist (tags, naming conventions) but they’re workarounds.
• Opinionated maintainer. The AlternativeTo reviewer [5] notes that GitHub Issues show the project leader rejecting requests when they don’t align with his vision. This isn’t unusual for solo-maintained open source, but it’s a real risk if you need the tool to evolve in a direction he disagrees with.
• Budget refund handling is broken by design. Refunds don’t offset budgets correctly — a documented limitation that affects real-world use [5].
• Data importer is a separate app. Automation of bank data requires installing, configuring, and maintaining a second container. This surprises new users who expect it to be included [README].
• No bank sync built in. Firefly III does not scrape your bank. Import is either manual entry, CSV upload, or via the separate importer using open banking APIs (where supported). Compared to YNAB’s direct bank connection, this is more friction [README].
• Post-install reliability complaints. At least one AlternativeTo reviewer reported database access failures appearing weeks after a successful install [5]. Isolated but worth knowing.
• AGPL-3.0 license. For personal use this changes nothing. If you’re building a product on top of Firefly III, you need to understand the copyleft implications.

---

Who should use this / who shouldn’t

Use Firefly III if:

• You want to escape YNAB’s annual fee and are willing to spend a few hours on setup once.
• You care about where your financial data lives — you don’t want it on a cloud server you don’t control.
• You run a multi-person household and want shared finance tracking without paying per-user.
• You transact in multiple currencies and need a single tool that handles them properly.
• You want a REST API to build custom integrations (mobile apps, scripts, dashboards).
• You’re comfortable with Docker or have someone to help with deployment.
• You don’t need zero-sum budgeting — you want tracking, reporting, and goals, not strict allocation.

Skip it (use Actual Budget instead) if:

• You want a self-hosted tool with a more modern UI and simpler setup.
• Zero-sum budgeting actually works for you and you want the YNAB experience without the YNAB bill.
• You want the option to pay for a managed cloud version without running servers yourself.

Skip it (use YNAB) if:

• You want direct bank sync with minimal manual data entry and will pay for that convenience.
• You’ve internalized the “give every dollar a job” method and it works for your household.
• You need polished mobile apps and official support.

Skip it entirely if:

• You’re not technical and don’t have someone to set it up for you. A broken finance tracker is worse than no finance tracker — one AlternativeTo reviewer [5] lost hours to installation only to have it fail weeks later.
• You need subcategories. The maintainer won’t add them, so this is a hard blocker if subcategories are core to how you organize expenses [5].

---

Alternatives worth considering

From the AlternativeTo listing and the reviews:

• Actual Budget — the most direct self-hosted alternative. Modern UI, zero-sum budgeting model (closer to YNAB), easier setup. Free to self-host, $15/month for managed cloud. If Firefly III’s setup feels too complex, start here [2].
• YNAB — the incumbent cloud tool. Best bank sync, polished mobile apps, zero-sum method that genuinely works for many users. $109/year. If the bill doesn’t bother you and you don’t care about data sovereignty, YNAB is a better product experience.
• Mint — shut down January 2024. Not a real option [3].
• GnuCash — older desktop double-entry accounting software. More powerful for complex accounting scenarios, uglier and less web-friendly than Firefly III. Better for small business tracking, overkill for personal budgeting.
• Beancount — plain-text, command-line double-entry accounting. Loved by engineers, inaccessible to everyone else. If you know what it is, you’ve already decided.
• Kresus — another self-hosted option with built-in bank sync (EU-focused). Less feature-complete than Firefly III but easier to get running.
• HomeBank — desktop application (Windows/Linux/Mac). No server required, simpler setup, but no web access or multi-user support.

For a non-technical founder or household that just wants off a paid cloud tool, the realistic shortlist is Firefly III vs Actual Budget. Pick Firefly III if feature depth, double-entry rigor, multi-currency, and API access matter. Pick Actual Budget if setup simplicity and a cleaner UI matter more.

---

Bottom line

Firefly III is the most feature-complete self-hosted personal finance manager that exists. The double-entry bookkeeping, rule engine, piggy banks, multi-currency support, and REST API together make it closer to proper accounting software than a budgeting app. For a household that has been paying YNAB for years, the math is obvious: deploy once, pay for the server (or nothing if you’re already running one), and own your financial history forever.

The honest trade-off is that “deploy once” is not a small ask. The setup requires Docker, a database, a reverse proxy, and a separate importer tool. The maintainer is opinionated and has declined features — including subcategories — that users have wanted for years. If those constraints fit your situation, it’s an excellent tool. If they don’t, Actual Budget exists for a reason.

If the afternoon of setup is the blocker, that’s exactly what unsubbed.co’s parent studio upready.dev deploys for clients. One-time fee, done, you own the infrastructure.

---

Sources

1. Ayush Pande, XDA Developers — “5 ways self-hosting Firefly III fixed my budgeting (and why it’s better than tools like YNAB)” (May 23, 2025). https://www.xda-developers.com/self-hosting-firefly-iii-fixed-my-budgeting/
2. oddwired.com — “From Counter Books to Self-Hosted Finance Tracking: My Journey with Firefly III”. https://oddwired.com/from-counter-books-to-self-hosted-finance-tracking-my-journey-with-firefly-iii/
3. Reddit r/selfhosted — “Firefly iii vs” (community thread comparing Firefly III to Mint and other options). https://www.reddit.com/r/selfhosted/comments/11w5068/firefly_iii_vs/
4. GoodFirms — “Firefly III Reviews & Pricing 2026”. https://www.goodfirms.co/software/firefly-iii
5. AlternativeTo — “Firefly III: A free and open source personal finance manager” (user reviews and ratings). https://alternativeto.net/software/firefly-iii/about/
6. LinuxLinks — “Firefly III - self-hosted financial manager”. https://www.linuxlinks.com/firefly-iii-self-hosted-financial-manager/

Primary sources:

• GitHub repository and README: https://github.com/firefly-iii/firefly-iii (22,683 stars, AGPL-3.0)
• Official website: https://www.firefly-iii.org
• Documentation: https://docs.firefly-iii.org/
• Live demo: https://demo.firefly-iii.org/