Skip to content

Firefly III and Firefly III data importer

A free and open source personal finance manager.

View the nix-core NixOS module on GitHub.

References

Firefly III

Firefly III data importer

Sops

Provide the following entries to your host's secrets.yaml:

Replace abc123 with your actual secrets

firefly-iii:
    appkey: abc123 # for `services.firefly-iii.settings.APP_KEY_FILE`
    smtp-password: abc123
    hashed-smtp-password: abc123

Generate your app key with:

head -c 32 /dev/urandom | base64

Generate the hashed SMTP password with:

nix-shell -p mkpasswd --run 'mkpasswd -sm bcrypt'

For more info, see our mailserver module.

Setup

Set CNAME records for your Firefly III and Firefly III data importer subdomains pointing to your domain.

Firefly III

  1. Visit "SUBDOMAIN.DOMAIN.TLD" in a browser.
  2. Create an admin account.
  3. Follow the on screen guide "Getting started".
  4. Create a OAuth client for your data importer instance.
    1. Go to Options > Profile > OAuth
    2. Click Create New Client
      • Name: Can be anything
      • Redirect URL: https://IMPORTER_SUBDOMAIN.DOMAIN.TLD/callback
      • Confidential: Uncheck
    3. Click Create. Take note of the Client ID.

Firefly III data importer

  1. Visit IMPORTER_SUBDOMAIN.DOMAIN.TLD in a browser.
    • Firefly III URL: https://SUBDOMAIN.DOMAIN.TLD
    • Client ID: Client ID from above
  2. Click Submit
  3. Click Authorize