Skip to main content


Updating Firefly III.

Create the folder with the new version:

composer create-project grumpydictator/firefly-iii --no-dev --prefer-dist firefly-iii-updated <next_version>

Get the next_version from here:

Copy the important files from the current version:

cp firefly-iii/.env firefly-iii-updated/.env
cp firefly-iii/storage/upload/* firefly-iii-updated/storage/upload/
cp firefly-iii/storage/export/* firefly-iii-updated/storage/export/

No such file or directory is not an error!

Change the owner of the directory:

chown -R www-data:www-data firefly-iii-updated/

Change the mode:

chmod -R 0775 firefly-iii-updated/

Change the current user to www-data:

sudo -u www-data /bin/bash

Go to the new directory:

cd firefly-iii-updated/

Run the following commands:

rm -rf bootstrap/cache/*
php artisan cache:clear
php artisan migrate --seed
php artisan firefly-iii:upgrade-database
php artisan passport:install
php artisan cache:clear

Go back:

exit && cd ..

Delete the older version (if have):

rm -r firefly-iii-old/

Swap the directory with the new one:

mv firefly-iii firefly-iii-old
mv firefly-iii-updated/ firefly-iii

Restart Nginx:

systemctl restart nginx.service

Restart PHP-FPM:

systemctl restart php8.1-fpm.service

The full documentation: