invoiceninja/docs/update.rst

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 <https://pastebin.com/j657uv9A>`_ 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.

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.

.. code-block:: shell

   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 <https://github.com/invoiceninja/invoiceninja/releases>`_.

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.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
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00			`Update`
			`======`

Add composer install to update docs 2017-03-22 12:58:40 +01:00			`.. NOTE:: We recommend backing up your database before updating the app.`
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
Working on docs 2017-01-26 19:08:48 +01:00			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.
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
Add download link to update docs 2017-08-17 09:35:51 +02:00			`https://download.invoiceninja.com`

update docs 2017-11-07 09:55:45 +01:00			.. TIP:: We recommend using this `shell script <https://pastebin.com/j657uv9A>`_ to automate the update process, run it as a daily cron to automatically keep your app up to date.
Update docs 2017-06-26 20:52:14 +02:00
Update docs 2017-06-04 15:05:51 +02:00			`If you're moving servers make sure to copy over the .env file.`

Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00			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.

Update docs 2017-12-06 13:04:52 +01:00			`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.`

Working on docs 2017-01-26 16:37:35 +01:00			`.. code-block:: shell`
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
Working on docs 2017-01-26 16:37:35 +01:00			`composer dump-autoload --optimize`
			`php artisan optimize --force`
			`php artisan migrate`
			`php artisan db:seed --class=UpdateSeeder`
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
Add composer install to update docs 2017-03-22 12:58:40 +01:00			.. NOTE:: If you've downloaded the code from GitHub you also need to run ``composer install``

Update docs 2017-05-22 11:46:01 +02:00			.. TIP:: You can see the detailed changes for each release on our `GitHub release notes <https://github.com/invoiceninja/invoiceninja/releases>`_.

Update min php to 7 2017-11-15 10:54:23 +01:00			`Version 4.0`
			`"""""""""""""`

			`The minimum PHP version is now 7.0.0`

Update docs 2017-12-14 10:17:27 +01:00			If you're using a rijndael cipher run ``php artisan ninja:update-key --legacy=true`` to change to AES-256-CBC.

Update docs 2017-04-12 08:50:23 +02:00			`Version 3.2`
			`"""""""""""`

Update docs 2017-04-12 09:08:10 +02:00			An import folder has been adding to storage/, you may need to run ``sudo chown -R www-data:www-data storage``
Update docs 2017-04-12 08:50:23 +02:00
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00			`Version 2.6`
			`"""""""""""`

Working on docs 2017-01-26 16:37:35 +01:00			Make sure the .env file includes ``APP_CIPHER=rijndael-128``
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
			`Version 2.5.1`
			`"""""""""""""`
Update min php to 7 2017-11-15 10:54:23 +01:00
			`The minimum PHP version is now 5.5.9`
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
			`Version 2.0`
			`"""""""""""`

Working on docs 2017-01-26 16:37:35 +01:00			`Copy .env.example to .env and set config settings`
Moving self host docs to readthedocs 2017-01-26 16:19:44 +01:00
			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