Updates

Pre-requisites

Don’t execute anything from the installation steps before or after your update
Make sure that you have a working database backup before you start the update
Read the UPGRADING guide and the release information to check if there are further manual steps required for one of the version between yours and the new one

Update process

Some tweaks may be necessary to these instructions if you have a developer setup or update on your local computer instead of a server. Read the installation docu for more information.

Change into your Kimai directory, then fetch the latest code and install all dependencies. You might have to prefix the composer and bin/console commands with sudo -u www-data (depends on your setup):

git fetch --tags
git checkout 1.7
composer install --no-dev --optimize-autoloader

And run the Kimai updater:

bin/console kimai:update

Remember to adjust the file permissions if necessary. Test Kimai before executing these commands (they are likely not required in a shared-hosting environment). Here is an example for Debian based OS:

chown -R :www-data .
chmod -R g+r .
chmod -R g+rw var/
chmod -R g+rw public/avatars/

Important: Finally execute the version specific tasks from the UPGRADING guide.

That’s it, Kimai is running the most current version. Enjoy the latest time-tracking features!