Firefly III — Self-Hosted Personal Finance Manager

What it is

Firefly III is an open-source personal finance manager for tracking expenses, budgets, and bank accounts. It runs self-hosted with full privacy, supports multiple currencies, and provides powerful reporting. You manage transactions, set budgets, and track spending categories through a web interface.

Firefly III targets anyone who wants full control over their financial data without relying on cloud services like Mint or YNAB. It supports manual transaction entry, bank import via CSV/OFX, and automated imports through the data importer companion tool.

How it saves time or tokens

Firefly III replaces spreadsheets and cloud finance apps with a structured, self-hosted solution. The budgeting system automatically tracks spending against budgets and shows remaining amounts. Recurring transaction rules handle regular bills without manual entry. Multi-currency support handles travel expenses and international accounts automatically. The reporting dashboard visualizes spending trends without manual chart creation.

How to use

1. Deploy with Docker:

docker run -d --name firefly \
  -p 8080:8080 \
  -e APP_KEY=SomeRandomStringOf32Characters!! \
  -e DB_CONNECTION=sqlite \
  -v firefly-data:/var/www/html/storage \
  fireflyiii/core:latest

1. Open http://localhost:8080, register your account, and start adding transactions.

1. Set up budgets, categories, and recurring rules.

1. Import bank statements via CSV or connect the data importer.

Example

# docker-compose.yml for Firefly III with PostgreSQL
services:
  firefly:
    image: fireflyiii/core:latest
    ports:
      - '8080:8080'
    environment:
      APP_KEY: change-me-32-characters-long!!!!!
      DB_CONNECTION: pgsql
      DB_HOST: postgres
      DB_DATABASE: firefly
      DB_USERNAME: firefly
      DB_PASSWORD: secret
    depends_on:
      - postgres
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: firefly
      POSTGRES_USER: firefly
      POSTGRES_PASSWORD: secret
    volumes:
      - firefly-db:/var/lib/postgresql/data
volumes:
  firefly-db:

Related on TokRepo

• Self-Hosted Tools — Self-hosted alternatives to commercial SaaS
• Featured Workflows — Top-rated open-source tools

This tool integrates with standard development workflows and requires minimal configuration to get started. It is available as open-source software with documentation and community support through the official repository. The project follows semantic versioning for stable releases.

For teams evaluating this tool, the key advantage is reducing manual work in repetitive tasks. The automation provided by the built-in features means less custom code to maintain and fewer integration points to manage. This translates directly to lower maintenance costs and faster iteration cycles.

Common pitfalls

• The APP_KEY must be exactly 32 characters and should be generated securely; do not reuse the example key in production.
• SQLite works for single-user setups but does not handle concurrent access well; use PostgreSQL or MySQL for reliability.
• Bank import requires the separate Firefly III Data Importer tool; it is not built into the main application.