Releases: firefly-iii/data-importer
Development release for 2026-01-07
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-01-07 @ 03: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.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.
Contributors
Assets 9
v1.9.0
Welcome to release v1.9.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
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.
Contributors
Assets 9
v1.8.4
Welcome to release v1.8.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
Fixed
- Issue 11061 (Importing using
importer:auto-importresults in error "foreach() argument must be of type array|object, string given") reported by @jurgenhaas
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.8.3
Welcome to release v1.8.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
Added
- Issue 11032 (Data importer interprets decimal separator as thousands separator) reported by @beatbesmer
- Update Salt Edge API to use v6 by @bedesv
Fixed
- Issue 11000 (fontawesome v7 not compatible with current app.scss) reported by @Linguardium
- Discussion 11001 (Venmo Transactions not working with Simplefin) started by @fighterjetj
- Issue 11040 (AutoImport triggered by POST only imports last file) reported by @beatbesmer
- Fixed fonts in build, by @Linguardium
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.8.2
Welcome to release v1.8.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
Fixed
- Issue 10983 (CANNOT_PARSE_CONFIG thrown on Importer-Image 1.8.0) reported by @beatbesmer
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.8.1
Welcome to release v1.8.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
Added
- #6061
Changed
- #10947
Removed
- Add message about future removal of Spectre / Salt Edge.
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.
v1.8.0
Welcome to release v1.8.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
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.
Added
- Issue 9045 (Data Importer - Add config filename or bank name into end-of-import email) reported by @Terry-JF
- Issue 10923 ([Importer] CSV import broken in cli image (does not adhere to the v3 schema)) reported by @MacPaille
- JSON Schema validation for the configuration file.
Changed
- Issue 10863 (Data Importer: GoCardless: option to use internalTransactionId instead) reported by @diogotcorreia
- Issue 10914 (GoCardless importer: external_id dedupe should be per account) reported by @Jazzmax
Fixed
- Fix issue with restoring empty
accountsarray from configuration.
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.7.10
Welcome to release v1.7.10 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.
Changelog
Deprecated
- Support for Firefly III < v6.3.2
Fixed
- Issue 10699 ([Importer] SimpleFIN error - create flag must be set for new account creation with de-selected accounts) reported by @Siddhant-k
- Issue 10805 (Importer: Importer loops when there are no tractions to import from SimpleFin) reported by @Kage1
- Eternal loop in UI, reported by @Kage1
- Date range can be selected out of order, breaking the import, reported by @Kage1
- Selecting transactions from a single day doesn't work, reported by @Kage1
- Loop back to role selection has the wrong label, reported by @Kage1
- Pending transactions were always imported, reported by @Kage1
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.
