mirror of
https://github.com/invoiceninja/invoiceninja.git
synced 2024-11-08 20:22:42 +01:00
66 lines
2.6 KiB
ReStructuredText
66 lines
2.6 KiB
ReStructuredText
Update
|
|
======
|
|
|
|
.. NOTE:: Note: v5 is now in beta. To upgrade from v4 you need to `install v5 <https://invoiceninja.github.io/docs/self-host-installation/>`_ as a separate app and then use the migration tool in the latest version of v4 on Settings > Account Management.
|
|
|
|
To update the app you just need to copy over the latest code. Do not be afraid to overwrite the files, the configuration file for connections such as mysql are stored in the .env file. 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
|
|
|
|
If you have trouble updating you can manually load /update to check for errors.
|
|
|
|
.. TIP:: We recommend using this `shell script <https://github.com/titan-fail/Ninja_Update>`_ 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 and the custom company logo(s) located in the public/logo directory. For attachments make sure you do not forget to copy the storage/documents directory.
|
|
|
|
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.
|
|
|
|
.. code-block:: shell
|
|
|
|
composer dump-autoload --optimize
|
|
php artisan optimize --force
|
|
php artisan migrate
|
|
php artisan db:seed --class=UpdateSeeder
|
|
|
|
A common error with shared hosting is "open_basedir restriction in effect", if you see this you'll need to either temporarily modify your open_basedir settings or run the update from the command line.
|
|
|
|
.. 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 <https://github.com/invoiceninja/invoiceninja/releases>`_.
|
|
|
|
Version 5.4.33
|
|
"""""""""""
|
|
|
|
The minimum PHP version is now 7.1.0
|
|
|
|
Version 4.3
|
|
"""""""""""
|
|
|
|
You may need to manually delete ``bootstrap/cache/compiled.php``.
|
|
|
|
Version 4.0
|
|
"""""""""""
|
|
|
|
The minimum PHP version is now 7.0.0
|
|
|
|
If you're using a rijndael cipher run ``php artisan ninja:update-key --legacy=true`` to change to AES-256-CBC.
|
|
|
|
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.5
|
|
"""""""""""
|
|
|
|
The minimum PHP version is now 5.5.9
|
|
|
|
Version 2.0
|
|
"""""""""""
|
|
|
|
Copy .env.example to .env and set config settings
|
|
|
|
If unset, set the app cipher to ``rijndael-256``.
|
|
|
|
Check that ``/path/to/ninja/storage`` has 755 permissions and is owned by the webserver user
|