Skip to content

Self-hosted installation


In order to run the data importer you need a working LAMP, LEMP or WAMP-stack running PHP 8.2 and access to the command line. Here are some Google queries to help you.

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

Also remember these Gists, which may help in case you run into issues:

  1. Firefly-III CSV-Importer Ubuntu 20.04 Proxmox Installation Guide. Remember to change 'CSV' to 'data' where necessary.


The data importer will not work properly when installed or accessed through a subdirectory on your web server. If you run the data importer from /fidi, /importer or a similar subdirectory your mileage may vary and I can't support you.

Installation instructions

Preparing your server

Install extra packages

Install the following PHP modules:

  • PHP BCMath Arbitrary Precision Mathematics

Install composer

You need to install composer or download composer.

Installing the data importer

Main command

The assumption is that you will install the data importer in /var/www. Go to the installation directory.

cd /var/www && \
composer create-project firefly-iii/data-importer \
    --no-dev --prefer-dist data-importer 1.2.2

If this gives an error because of access rights, you can be lazy. Use sudo. Then, fix the access rights:

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


In the data-importer directory you will find a .env file. There are instructions what to do in this file. If you can't find this file, copy .env.example into .env.

Reverse proxies

To run the data importer behind a reverse proxy, set the TRUSTED_PROXIES environment variable to either * or the IP address of your reverse proxy.


To enable TLS in the data importer, your reverse proxy must be configured correctly. Here is some code for nginx:

proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Server $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
client_max_body_size 64M;
proxy_read_timeout 300s;

Accessing the data importer

You can access the data importer at http://localhost/. If this URL is taken by Firefly III already, validate your server configuration accepts both. This is called a "virtual host", and out of the scope of this installation guide.

Opening screen of the data importer.

Need help?

If something did not go as expected, please browse to the FAQ or the Support pages.

Last update: 2023-03-26