Releases: firefly-iii/data-importer
Development release for 2026-02-24
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-02-24 @ 05:50 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.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.
Contributors
Assets 9
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.
Contributors
Assets 9
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.
Contributors
Assets 9
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.
Contributors
Assets 9
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.
Contributors
Assets 9
v2.0.2
Welcome to release v2.0.2 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 and a regression bug I introduced in v2.0.1.
Fixed
- Issue 11482 (Data importer loops from Convert -> Map -> Convert when importing from external providers) reported by @avee87
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.
Contributors
Assets 9
v2.0.1
Welcome to release v2.0.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
This release fixes some issues left in v2.0.0.
Fixed
- Various code related bugs not reported as an issue.
- Various issues reported in our Gitter.im chatroom, thank you!
- Issue 11459 (CVS data conversion crashes on missing field in conversion routine code) reported by @Sycoraxya
- Issue 11460 (Importer does not create transactions with foreign_amount and foreign_currency_code from CAMT imports) reported by @vizzerdrix55
- Issue 11470 (Non UTF-8 files cannot be handled as file uploads) reported by @andyesten
- Issue 11477 (Old redirect URL is not properly handled during data conversion) reported by @avee87
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.
Contributors
Assets 9
v2.0.0
Welcome to release v2.0.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
Version 2.0 of the Firefly III data importer introduces some big architectural changes that should make it easier to work with, and easier to extend.
Warning
This release introduces many new things, so there will be bugs. Some changes in this release may also 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.
Added
- New import data provider "Sophtron". In the interest of full disclosure, they have sponsored me to add their API to the data importer. Their support (and yours!) allows me to spend more time on Firefly III and the data importer, and I'm very grateful for it.
- PR 1035 (Add support for CAMT.052) by @beatbesmer
- PR 1037 (Syntax error in debug logging) by @beatbesmer
Changed
- Import jobs are no longer managed using session data. This is a technical change, and it means that import jobs are easier to monitor, update and (in the future) can be re-run using new settings. This allows for a whole new range of flexibility.
- A lot of code has been rewritten to make it easier to manage an import job. Thanks to the previously mentioned changed, it is easier to switch back and forth between the necessary steps of an import job.
- A small API is now in place (with documentation to follow), that allows you to communicate with the data importer more easily. This will not be relevant for a lot of folks but the "auto import" and "auto upload" endpoints for example, will be documented just like the Firefly III API documentation.
Deprecated
- The "Spectre" import routine created and supported by Salt Edge, has been officially deprecated and can no longer be used.
Fixed
- Discussion 11162 (Importer account generation via account number) started by @ahmetpekbas
- Issue 11172 (Special characters not sorted correctly in account mapping) reported by @empeig
- Issue 11327 (SimpleFIN import fails with "Account mappings cannot be empty" even when "Map data: NO" is selected) reported by @metalchef1
- Issue 11377 (Importer ignores date option set in config file) reported by @rmu1987
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.
Contributors
Assets 9
v1.9.1
Welcome to release v1.9.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
Note
Lunch Flow support is new to the Data Importer. Please read the tutorial carefully. Feel free to open an issue or start a discussion if you have issues. Thanks in advance for your support!
Added
- Issue 10849 (Integrate Lunch Flow with the data importer) reported by @JC5
- Lunch Flow support was also brought to you by @amrawadk
Fixed
- Issue 11075 (Importer handling of conflicting range options) reported by @molnarti
- Issue 11070 (GoCardless API no longer available) reported by @jgelon
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.
