1. Make sure that you have a working database backup before you start the update
  2. Check UPGRADING for required manual changes between your current and the new version
  3. You can upgrade multiple version at once, eg. from 1.6 to 1.8 while skipping 1.7

Updating Kimai

Change into your Kimai directory, then fetch the latest code and install all dependencies:

git fetch --tags
git checkout 1.8

You might have to prefix the the next commands with sudo and/or php73 (depends on your environment):

Update all composer dependencies:

composer install --no-dev --optimize-autoloader

And run the Kimai updater:

bin/console kimai:update

Remember to adjust the file permissions if necessary.

Fix Kimai file permission

You have to allow PHP (your webserver process) to write to var/ and it subdirectories.

Here is an example for Debian/Ubuntu (to be executed inside the Kimai directory):

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

Test Kimai before executing these commands (they are likely not required in a shared-hosting environment). You probably need to prefix them with sudo and the group might be called different than www-data.

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