Update

Note

We recommend backing up your database before updating the app.

To update the app you just need to copy over the latest code. The app tracks the current version in a file called version.txt, if it notices a change it loads /update to run the database migrations.

https://download.invoiceninja.com

Tip

We recommend using this shell script to automate the update process, run it as a daily cron to automatically keep your app up to date.

If you’re moving servers make sure to copy over the .env file.

If the auto-update fails you can manually run the update with the following commands. Once completed add ?clear_cache=true to the end of the URL to clear the application cache.

composer dump-autoload --optimize
php artisan optimize --force
php artisan migrate
php artisan db:seed --class=UpdateSeeder

Note

If you’ve downloaded the code from GitHub you also need to run composer install

Tip

You can see the detailed changes for each release on our GitHub release notes.

Version 4.0

The minimum PHP version is now 7.0.0

Version 3.2

An import folder has been adding to storage/, you may need to run sudo chown -R www-data:www-data storage

Version 2.6

Make sure the .env file includes APP_CIPHER=rijndael-128

Version 2.5.1

The minimum PHP version is now 5.5.9

Version 2.0

Copy .env.example to .env and set config settings

Set the app cipher to rijndael-256 to support existing passwords

Check that /path/to/ninja/storage has 755 permissions and is owned by the webserver user