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.
You won't need to set up a database.
Preparing your server
Extra packages
Install the following PHP modules:
- PHP BCMath Arbitrary Precision Mathematics
- PHP JSON
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 https://getcomposer.org/installer | 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.
Spectre
composer create-project firefly-iii/spectre-importer --no-dev --prefer-dist spectre-importer <latest>
YNAB
composer create-project firefly-iii/ynab-importer --no-dev --prefer-dist ynab-importer <latest>
bunq
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.
Configuration
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.
If this is not the case, or something is broken, be sure to open an issue on GitHub or check out the FAQ.