Skip to content

Configure your installation

The Firefly III Data Importer (FIDI) communicates with Firefly III over the API. You can supply FIDI with a few pieces of information to make it easy to connect to your Firefly III installation.

On this page you will read how to:

  1. Configure FIDI to connect to Firefly III.
  2. Configure Nordigen (optional)
  3. Configure Spectre (optional)
  4. Where to set these variables.

Configure FIDI

You must tell FIDI where to reach Firefly III. This is set in the FIREFLY_III_URL environment variable. Make sure you REMOVE any trailing slash from the end of the URL.

For Docker, you may be able to use the internal IP address of Firefly III, instead of its public address. But if normal users can't reach this URL, you must also set the VANITY_URL. Here is an example:

  • FIREFLY_III_URL=http://172.16.2.2:8080 (internal Docker URL)
  • VANITY_URL=https://money.bill-gates.com (public or local URL)

To authenticate with Firefly III you must set ONE the following variables:

  1. Set a Personal Access Token in the FIREFLY_III_ACCESS_TOKEN environment variable.
  2. OR Set a Client ID in the FIREFLY_III_CLIENT_ID environment variable.

Important

A Docker installation will never be able to connect a Firefly III installation located at http://localhost or http://127.0.0.1 because this address refers to the Docker container itself, and not Firefly III.

Information

Firefly III combined with external identity providers such as Authelia can only handle Personal Access Tokens.

Configure Nordigen

To configure Nordigen, set the following variables. This is necessary if you wish to connect to your bank through Nordigen.

  • NORDIGEN_ID is your Nordigen Client ID
  • NORDIGEN_KEY is your Nordigen Client Secret
  • If you set NORDIGEN_SANDBOX to true FIDI will only connect to the Nordigen sandbox.

Configure Spectre

To configure Spectre, set the following variables. This is necessary if you wish to connect to your bank through Spectre.

  • SPECTRE_APP_ID is your Spectre / Salt Edge Client ID
  • SPECTRE_SECRET is your Spectre / Salt Edge Client secret

Where to set the configuration?

The configuration values are stored in environment variables:

  • FIREFLY_III_URL
  • FIREFLY_III_ACCESS_TOKEN
  • FIREFLY_III_CLIENT_ID
  • NORDIGEN_ID and NORDIGEN_KEY
  • SPECTRE_APP_ID and SPECTRE_SECRET

You can use the .env file to store them, use Docker's -e flag to set them or use your operating system to set these values. This depends on your installation method, Docker or self hosted.

Important

You may need to clear your cookies, browse to /flush or press [Reauthenticate] after changing these values.

How to get these variables?

You can generate your own Personal Access Token on the Profile page. Login to your Firefly III instance, go to "Options" > "Profile" > "OAuth" and find "Personal Access Tokens". Create a new Personal Access Token by clicking on "Create New Token". Give it a recognizable name and press "Create". The Personal Access Token is pretty long. Use a tool like Notepad++ or Visual Studio Code to copy-and-paste it.

Click the right button.

Give the personal access token a name.

Copy and paste the token for use in the importer.

Authentication is reported.

Client ID + Firefly III URL

You can generate your own client ID on your Profile page (under OAuth). This is the ID you need when you want to share FIDI with multiple people, or when you want to allow others to use the same instance of FIDI.

Make sure you uncheck the "confidential" checkbox.

It is very important that the callback URL is correct. The callback is the following:

http://[DATA IMPORTER]/callback

Some common examples include:

But ALWAYS add /callback or you'll run into weird errors later.

This is the correct client ID

Fill in the details correctly

Last update: 2023-01-29