Development release for 2026-04-09

Welcome to the latest development of the Firefly III Data Importer. This development release contains the latest fixes and features. It is probably buggy and may not work as expected. You can download the release below, and adventurous Docker users can find this release under the develop tag.

Warning

Some changes in this release may unexpectedly lead to duplicate transactions. This is caused by changes in the data handling routines. This is unfortunate, but a result of new insights, changed APIs and other minor fixes. My apologies for any inconvenience. I try to avoid these kinds of changes, but it can't always be helped.

Development releases are created to test new features and fixes before they are included in a stable release. They are not recommended for production use. This release was created on 2026-04-09 @ 02:19 and may contain unexpected bugs. Data loss is rare but possible.

Changelog

The changelog for this release may not be up-to-date, so it is not included. However, changelog.md may already contain entries for the future release.

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The release files are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.2.3

Welcome to release v2.2.3 of the Firefly III Data Importer. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Warning

Some changes in this release may lead to duplicate transactions. This is caused by changes in the data handling routines. This is unfortunate, but a result of new insights, changed APIs and other minor fixes. My apologies for any inconvenience. I try to avoid these kinds of changes, but it can't always be helped.

Fixed

• Issue 12041 (ignore_duplicate_transactions is not taken into account) reported by @Passific
• Issue 12073 (Clarify _FILE is already supported for MAIL_DESTINATION in importer.env) reported by @elp3dr0
• Issue 12093 (EnableBanking: duplicate detection fails due to session-scoped accountUid in external_id) reported by @dominikheiss

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.2.2

Welcome to release v2.2.2 of the Firefly III Data Importer. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Warning

Some changes in this release may lead to duplicate transactions. This is caused by changes in the data handling routines. This is unfortunate, but a result of new insights, changed APIs and other minor fixes. My apologies for any inconvenience. I try to avoid these kinds of changes, but it can't always be helped.

Removed

• Removed all instances of isset
• Removed old Spectre code

Changed

• Can now add Enable Banking private key as raw PEM string.

Fixed

• Issue 11917 (Enable Banking continuation key not used) reported by @victor-amblard
• Issue 11923 (Positive transactions in CAMT files fail to import) reported by @rmu1987
• Issue 11924 ("Missing array offset", broken auto-import when using import configuration with no flow key) reported by @Unsantae
• Issue 11925 (Enable Banking does not find duplicate transactions when changing status) reported by @rigibe
• Issue 11932 (ignore_duplicate_transactions field is not updated in the import_config.json) reported by @Passific
• Discussion 11959 ([Importer] SimpleFIN uses “posted_at” instead of “transacted_at” field for Transaction Date) started by @Siddhant-k
• Fix a missing JS variable

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.2.1

Welcome to release v2.2.1 of the Firefly III Data Importer. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Added

• Issue 11884 (Add BBAN to Enable Banking imports for better transfer matching) reported by @zorknemsis

Fixed

• Issue 11906 (AUTO_IMPORT_SECRET is not validated correctly) reported by @ict
• Fix various code quality issues.

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.2.0

Welcome to release v2.2.0 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Important

This release is the same as 2.1.1, but only works on PHP 8.5 and higher. To continue using the latest version of the data importer, you must upgrade to (at least) PHP 8.5.0, or switch to the Docker containers.

Fixed

• Issue 11775 (Data-importer 2.1.1 CAMT: Exception occurs parsing amount) reported by @lindely
• Issue 11777 (Fix for issue 11775 not working) reported by @lindely
• Issue 11783 (Firefly importer: Map income / transfer) reported by @Kiekeboe100

Security

• Some AI bot found a mild security issue in SimpleFIN token parsing, so I fixed that.

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.1.1

Welcome to release v2.1.1 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Warning

If no pressing issues get reported, this release will be followed by v2.2.0. It will be exactly the same but require PHP 8.5.

Fixed

• Issue 11753 (Enable Banking importer doesn't work when re-using a config json) reported by @icewind1991

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.1.0

Welcome to release v2.1.0 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Added

• GitHub user @barreeeiroo built support for Enable Banking. Read more about it in the documentation.
• Support for batch submissions
• Issue 10753 (Add Enable Banking to Data Importer as alternative to GoCardless) reported by @Madnex

Fixed

• Default currency validation for SimpleFIN
• Issue 11539 (Importing camt.053 file fails if amount is 0.0) reported by @j-palms
• Issue 11577 (Two notification emails after import) reported by @ragnarkarlsson
• Issue 11600 ([Importer] GoCardless import skips manual mapping step) reported by @avee87
• Issue 11687 (SimpleFIN import fails for liability accounts (mortgage/loan/debt)) reported by @demahaffey
• Issue 11693 (EmptyAccounts task fails to set "(no name)" for withdrawals with empty destination) reported by @sqelirus

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.0.5

Welcome to release v2.0.5 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

Warning

This will be one of the last Firefly III data importer releases that supports PHP 8.4.

Fixed

• Issue 11504 (Date conversion error when importing a range from SimpleFIN) reported by @anarion80
• Issue 11521 (Importer CAMT file import fails server error 500) reported by @rmu1987
• Issue 11523 (Importer no longer outputs progress updates for submission) reported by @grgar
• Issue 11525 (SimpleFIN cannot convert account types and fails to import) reported by @tmkowalewski

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.0.4

Welcome to release v2.0.4 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

This release fixes some issues left in v2.0.0.

Fixed

• PR 1107 (Fix config key inconsistency in MapController) created by @egyptianbman

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.

v2.0.3

Welcome to release v2.0.3 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.

Changelog

This release fixes some issues left in v2.0.0.

Fixed

• Various issues reported in the gitter.im-chat room, thank you!
• Various issues reported over mail, thanks!
• Issue 11485 (Importer doesn't skip mapping, fails to find accounts when using SimpleFIN) reported by @Kage1
• Issue 11486 (Importer fails non-gracefully with expired GoCardless requisition) reported by @molnarti
• Issue 11487 (Initial SimpleFIN import fails during data conversion with "Cannot access private property...") reported by @tmkowalewski
• Issue 11491 (Importer redirects without starting job when "skip configuration" is true) reported by @danielpngr

Installation and upgrade instructions

• Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
• Or read the upgrade instructions for Docker, Kubernetes or self-managed servers

The releases are signed, and you can verify them using the Firefly III releases PGP key.

Develop with Firefly III

Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.

Support Firefly III

Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.