You have to backup the following files:
The following stuff needs attention as well, backup if necessary:
Write down the exact version of your Kimai installation:
git rev-parse HEAD
.envto your imported database
At this step: test Kimai again and don’t proceed before it works as expected!
Working properly? Fine, then go ahead and restore all other files:
Still not satisfied and want to upgrade to the latest version?
Great! Make sure you have the
migration_versions table in your database backup,
before you upgrade. If not, execute
bin/console doctrine:migrations:version --add --all
beforehand and read the installation docs again,
if you might have missed other points as well.
Now you can upgrade :-)
You restored Kimai (as documented above), but have problems when accessing it?
Maybe you have have missed an upgrade steps, which you would have done when executing a normal upgrade.
Please check the UPGRADING guide and make sure you executed all version specific tasks.
If Kimai will not load properly (e.g. you only see a white screen, maybe some pages work) the database could be the reason.
This problem can happen when you install a different (newer) version that has a different database structure then your backup.
Check your database if you have the
migration_versions table. If not, go back to “Restore”.
If so: try to execute the missing database migrations with
You see an error when executing
This problem can happen when a configuration change is necessary in your
Please check the UPGRADING guide.