Kimai plugins are stored in
var/plugins/, for example
Installation should be done with
git clone or with a copy task.
Make sure that you copy it into the appropriate subdirectory in
For the plugin
CustomCSSBundle this would be
var/plugins/CustomCSSBundle/ (there should be a file
After the plugin was installed you need to clear the cache (see below).
You can disable plugins by creating a file called
.disabled in the plugin directory, e.g.
You need to clear the cache afterwards (see below).
To uninstall a plugin, you simply have to delete the directory, e.g.
Now clear the cache (see below).
There are three main reasons, why you might experience a 500 error after plugin installation:
It is not advised, but in case the above command fails you could try:
Depending on your setup, the cache flush will create directories which cannot be written by your webserver:
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):
Test Kimai before executing these commands (they are likely not required in a shared-hosting environment).
You probably need to prefix them with
the group might be called different than