Firefly III

Personal finance manager for budgets, accounts and transactions

  • ghcr.io/hsinghhira/firefly-iii:1.0.2
  • version-6.7.9
  • Updated 21 Nov 2026
  • port 6771
  • amd64 · arm64
  • Finance
  • 25.3k stars

Screenshots

Firefly III screenshot 1: Dashboard

Open the app

Web UI

http://localhost:6771/

API

http://localhost:6771/api/v1/about

About Firefly III

Firefly III helps you keep track of your money. Add your bank accounts, credit cards and cash, record what you spend and earn, and see where your money goes. Budgets, bills and piggy banks help you plan ahead. It uses a built-in SQLite database, so it is one container with nothing else to set up.

Features

  • Accounts, transactions, transfers and split transactions
  • Budgets, categories, tags and bills
  • Piggy banks to save for something
  • Rules that sort new transactions for you
  • Recurring transactions, run every day by the built-in job
  • Reports and charts, in many currencies
  • Import from your bank with the Data Importer, and a full API

How to use

  1. Open Firefly III from your dashboard.
  2. Click Register and make your account. The first account is the admin.
  3. Follow the first steps: add your main bank account and its balance.
  4. Add transactions, or import them from your bank.
  5. Make budgets and look at the reports.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6771. There is no account yet: click Register, and the first account you make is the admin. Set DEFAULT_LANGUAGE if you want another language. The app key and the cron token are made for you on first start and kept in /DATA/AppData/firefly-iii/database, and the daily jobs (recurring transactions, bill reminders) run inside the container. Email, proxy sign-in and the other settings are in the Variables tab and are added in the app settings. It is ready in about a minute.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone and used for dates and the daily jobs.
SITE_OWNER[email protected]Your email. Firefly III shows it on error pages and sends errors to it when email is set up.
DEFAULT_LANGUAGEen_USThe language for new users, like en_US, en_GB, de_DE, fr_FR, nl_NL or es_ES. Each user can change it later.

Server

VariableDefault valueDescription
APP_URLhttp://localhost:6771The address you open Firefly III at, like http://192.168.1.20:6771. Used in email links.
TRUSTED_PROXIES—Set to ** when a reverse proxy is in front of Firefly III, so it sees https and the real visitor address.
DEFAULT_LOCALEequalHow numbers and dates look, like en_US or de_DE. equal follows DEFAULT_LANGUAGE.
APP_LOG_LEVELnoticeHow much goes in the log: debug, info, notice, warning or error.
AUDIT_LOG_LEVELemergencySet to info to log every change to your data.
APP_KEY—The key your data is encrypted with, exactly 32 characters. It is made on first start and kept in the database folder. Only set it to move an old install.
STATIC_CRON_TOKEN—The 32-character token for the daily job URL. It is made on first start; only set it to call the job from outside.
COOKIE_SECUREfalseSet to true when you only open Firefly III over https.
PHP_MEMORY_LIMIT512MMemory PHP may use. Raise it for big imports.

Sign-in

VariableDefault valueDescription
AUTHENTICATION_GUARDwebSet to remote_user_guard to sign in through a proxy like Authelia.
AUTHENTICATION_GUARD_HEADERREMOTE_USERThe header that proxy puts the user in.
AUTHENTICATION_GUARD_EMAIL—The header that proxy puts the email in.
CUSTOM_LOGOUT_URL—Where to go after signing out, for proxy sign-in.

Email

VariableDefault valueDescription
MAIL_MAILERlogSet to smtp to send email (password resets, bill reminders).
MAIL_HOST—Your email server, like smtp.gmail.com.
MAIL_PORT2525Your email server port, usually 587 or 465.
MAIL_FROM[email protected]The address emails are sent from.
MAIL_USERNAME—The user name for your email server.
MAIL_PASSWORD—The password for your email server.
MAIL_ENCRYPTION—tls for STARTTLS (587) or ssl (465).
SEND_ERROR_MESSAGEtrueSend errors to SITE_OWNER by email.

Maps

VariableDefault valueDescription
MAP_DEFAULT_LAT51.983333Where maps start, latitude.
MAP_DEFAULT_LONG5.916667Where maps start, longitude.
MAP_DEFAULT_ZOOM6How far maps are zoomed in at the start.
docker-compose.yml
name: firefly-iii

services:
  firefly-iii:
    image: ghcr.io/hsinghhira/firefly-iii:1.0.2
    container_name: firefly-iii
    restart: unless-stopped
    stop_grace_period: 30s
    stop_signal: SIGINT
    network_mode: bridge
    environment:
      - TZ=$TZ
      - [email protected]
      - DEFAULT_LANGUAGE=en_US
    ports:
      - target: 8080
        published: "6771"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/database
        target: /var/www/html/storage/database
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/upload
        target: /var/www/html/storage/upload
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 1024M
        reservations:
          cpus: "0.05"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/firefly-iii/icon.png
    x-casaos:
      id: com.icestore.firefly-iii
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone and
              used for dates and the daily jobs.
        - container: SITE_OWNER
          description:
            en_US: >-
              Your email. Firefly III shows it on error pages and sends
              errors to it when email is set up.
        - container: DEFAULT_LANGUAGE
          description:
            en_US: >-
              The language for new users, like en_US, en_GB, de_DE, fr_FR,
              nl_NL or es_ES. Each user can change it later.
      ports:
        - container: "8080"
          description:
            en_US: Firefly III web UI and API, published on host as 6771
      volumes:
        - container: /var/www/html/storage/database
          description:
            en_US: >-
              The SQLite database with all your accounts and transactions,
              and this install's own keys (secrets.env). Back it up.
        - container: /var/www/html/storage/upload
          description:
            en_US: >-
              Files you attach to transactions, like receipts.

x-casaos:
  id: com.icestore.firefly-iii
  architectures:
    - amd64
    - arm64
  main: firefly-iii
  author: HSinghHira
  category: Finance
  developer: James Cole
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/firefly-iii/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/firefly-iii/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/firefly-iii/screenshot-1.png
  title:
    en_US: Firefly III
  tagline:
    en_US: Personal finance manager for budgets, accounts and transactions
  description:
    en_US: >-
      Firefly III helps you keep track of your money. Add your bank
      accounts, credit cards and cash, record what you spend and earn, and
      see where your money goes. Budgets, bills and piggy banks help you
      plan ahead. It uses a built-in SQLite database, so it is one container
      with nothing else to set up.


      **Features**


      - Accounts, transactions, transfers and split transactions

      - Budgets, categories, tags and bills

      - Piggy banks to save for something

      - Rules that sort new transactions for you

      - Recurring transactions, run every day by the built-in job

      - Reports and charts, in many currencies

      - Import from your bank with the Data Importer, and a full API


      **How to use?**


      1. Open Firefly III from the ZimaOS dashboard.

      2. Click Register and make your account. The first account is the
         admin.

      3. Follow the first steps: add your main bank account and its
         balance.

      4. Add transactions, or import them from your bank.

      5. Make budgets and look at the reports.
  tips:
    before_install:
      en_US: >-
        1. Set DEFAULT_LANGUAGE to your language if it is not en_US.


        2. More settings, like email and the address used in email links,
           are listed on the Firefly III page at
           https://icestore.hsinghhira.me/app/firefly-iii/ (Variables tab).
           You can add them now or later in the app settings.


        3. Start the installation. It is ready in about a minute.


        4. Open http://[ZIMAOS-IP-ADDRESS]:6771 and click Register. The
           first account you make is the admin.
  index: /
  port_map: "6771"
  scheme: http
  is_uncontrolled: false
  version: "version-6.7.9"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6771
      - Built on fireflyiii/core version-6.7.9, with SQLite as the database
      - Each install makes its own APP_KEY and cron token on first start, and the daily jobs run inside the container
      - Fixed: Firefly III stopped at start with "failed to open error_log (/proc/self/fd/2): Permission denied".
      - 1.0.1 did not fix it; 1.0.2 does (the log pipes are now given to www-data correctly).
      - The store names the exact image version (1.0.2), so a new install downloads the fixed image instead of reusing an older one ZimaOS kept.
  repo: "https://github.com/firefly-iii/firefly-iii"
  support: "https://github.com/firefly-iii/firefly-iii/issues"
  docs: "https://docs.firefly-iii.org/"

Install Firefly III

Something not working with Firefly III?

Report it so it gets fixed, or ask for an app that is not here yet.

More Finance apps

See all