Skip to content


You can automate the data importer in various ways.

Automated imports over the command line

Firefly III can import from the command line. Either by calling the Docker container, or by using your self-hosted instance.


The following environment variable need to be set. This value must match the local directory. If you're using Docker, set it to /import.


Command line and Docker

When you're using Docker validate that you've mounted a directory with your files in it. This is something you must have done when you launched the Docker container, using for example -v /path/to/my/files:/import.

Import a single (CSV) file

Use the following command to import a single file:

# self hosted (CSV file)
php artisan importer:import file.json file.csv

# self hosted (other sources)
php artisan importer:import file.json

# docker (CSV file)
docker exec -it [container-id] php artisan importer:import file.json file.csv

# docker (other sources)
docker exec -it [container-id] php artisan importer:import file.json

The JSON file should always point to your JSON configuration file. If you are importing CSV files, replace file.csv with the full path to your CSV file.

Importing a directory

Another import option is present to import everything in a directory. Here are the necessary commands.

# self hosted
php artisan importer:auto-import /path/to/your/files

# docker
docker exec -it [container-id] php artisan importer:auto-import /import
  • For each CSV file to import you need two files: my-file.csv and my-file.json.
  • CSV files without a JSON file will be ignored.
  • JSON files without a CSV file will be tried as a Nordigen or Spectre import

Automatic imports using Docker

The following command will the data importer, and it will try to import whatever it finds in the current directory. This is fully automated. It works by mounting the current directory to /import and importing all files.

docker run \
--rm \
-v $PWD:/import \
-e WEB_SERVER=false \

Personal Access Token

This little trick only works when you use a personal access token.

Nordigen or Spectre information

If necessary, expand this command with the necessary Nordigen or Spectre keys and ID's.

Automated imports using the web (POST)


You can use the data importer's POST commands to import data. This page assumes you're self-hosting the data importer, although these commands also work when using Docker.

Personal Access Token required

The POST commands only work when you're using a Personal Access Token to authenticate.

Nordigen or Spectre information

You cannot submit Nordigen or Spectre information using the POST commands, the data importer must already be configured with them.

For all examples, the following environment variables need to be set:

# the secret is required and must be at least 16 characters long

# if this value is not set to true, you cannot upload files and impor tthem

# if this value is not set to true, you cannot import a local directory

# this value must match the local directory

Uploading files and importing them

CSV files: You can upload a CSV file and a JSON file to the CSV importer to have it imported into your Firefly III installation automatically. To illustrate how this works, here's a CURL request that works.

The CSV file and the JSON file will both be uploaded, after which the result will be a log of import attempt.

curl --location --request POST '' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ey....' \
--form 'importable=@"/local/path/to/csv.csv"' \
--form 'json=@"/local/path/to/json.json"'

You can also import from Nordigen or Spectre, in which case a JSON file is enough:

curl --location --request POST '' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ey....' \
--form 'json=@"/local/path/to/json.json"'

Importing a local directory

This POST command allows you to import from a local directory, where you have your files ready to go. For example, you have a directory called /import where bank.csv and bank.json are ready to go. In that case, you could do the following:

curl --location --request POST ''

The data importer will scroll through everything in the /import directory and import whatever is there. In other words, the POST command can trigger the import of files already present somewhere in a place where the data importer can read them.

Last update: 2023-03-26