Skip to content

Self hosted

In order to run the importer on your own machine, you'll need You need a working LAMP, LEMP or WAMP running PHP 8.0 and access to the command line. The installation routine for the importer is basically the same as it is for Firefly III itself.

If you don't have one, search the web to find out how to get one. Make sure you're running PHP 8.0. There are many tutorials that will help you install one. Here are some Google queries to help you.

  1. Install a LAMP stack with PHP 8.0
  2. Upgrade Ubuntu PHP 8.0
  3. PHP 8.0 raspberry pi

You won't need to set up a database.

Preparing your server

Extra packages

Install the following PHP modules:

  • PHP BCMath Arbitrary Precision Mathematics

You can search the web to find out how to install these PHP modules. Some may be installed already depending on your system. Use phpinfo() to find out.

Installing composer

If you have sudo rights (try sudo ls) you can install composer using the following command:

curl -sS | sudo php -- --install-dir=/usr/local/bin --filename=composer

Verify the installation of composer using the following command.

composer -v

If you have no sudo rights, you can simply download composer. Use php composer.phar instead of composer in the instructions ahead.

This concludes the server preparations. If you're having trouble with (parts of) this step, please check out the FAQ or open an issue on GitHub.

Installing the importer

Main command

Browse to /var/www which is probably the directory where your web server is configured to find its files. This depends on your own server of course.

Enter the following command.


composer create-project firefly-iii/spectre-importer --no-dev --prefer-dist spectre-importer <latest>


composer create-project firefly-iii/nordigen-importer --no-dev --prefer-dist nordigen-importer <latest>


composer create-project firefly-iii/ynab-importer --no-dev --prefer-dist ynab-importer <latest>


composer create-project firefly-iii/bunq-importer --no-dev --prefer-dist bunq-importer <latest>

You should replace <latest> with the latest version, which you can find on the Firefly III version page.

If this gives an error because of access rights, prepend the command with sudo. Then fix the access rights:

sudo chown -R www-data:www-data some-importer
sudo chmod -R 775 some-importer/storage

In general, these access rights aren't terrible important for the importer, as long as your web server can read all the files.


In the *-importer directory you will find a .env file. Open this file using your favorite editor. There are instructions what to do in this file. If you can't find this file, copy .env.example into .env and voila!

Accessing the importer

It depends on your installation and web server, but usually you can access the importer over http://localhost/. If this URL is taken by Firefly III already, make sure your server configuration accepts both. This is called a "virtual host".

Browsing to site

Browsing to the site should be easy. You should see the following screen, if your personal access token is configured correctly.

Opening screen of the Spectre importer.

Opening screen of the YNAB importer.

Opening screen of the bunq importer.

If this is not the case, or something is broken, be sure to open an issue on GitHub or check out the FAQ.

Last update: 2021-11-27