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.5
composer install --no-dev --optimize-autoloader

Refresh your cache:

bin/console cache:clear --env=prod
bin/console cache:warmup --env=prod

And upgrade your database:

bin/console doctrine:migrations:migrate

Remember to fix the file permissions if necessary (likely not required in a shared-hosting environment). Try if Kimai works without before executing this. 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!