99€ (excl. VAT)

Pricing for this item
Logo - HMR-IT GmbH


Software + App development company from Germany

A plugin for Kimai 2 which checks if one of your users violated the German break time law + nominal and actual work time comparison + overtime view
Last update: 09 Oct 2020


  • See if your users have overtimes or undertimes (since first day in company, per month, per day - all in separate views)
  • Check if they violate the German break time law “Arbeitszeitgesetz (ArbZG) § 4 Ruhepausen”
  • Users see how much overtimes or undertimes they have + how much they’ve worked already in the current month and how much they still have to work in the current month
  • Filter data per user, time period, and so on
  • E-Mail to user to notify him, that he has violated the German break time law via cronjob
  • Overview for Administrators to see all calculated times in one view
  • Get notified if one of your user’s birthday is coming soon
  • See all information in the dashboard
  • Get notified if one of your user has a anniversaries like 5 years in company
  • Handout for employees as PDF to see the worked hours of the month
  • Handout downloadable as a single PDF file for all employees or easy sendable via email to each employee (even to his private email account!)
  • Detect overlapping times with one click
  • See if your users have missing days (no times entered on days where they had to work)
  • Fully configurable via GUI
  • See with one view in Billing/Export tabs a summery of all entries which are not cleared yet


  • Custom-fields plugin to save the birthday of the user
  • Ability to create and run cronjobs
  • Kimai 2, V1.10+



Copy files

Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:


The file structure needs to like like this afterwards:

├── ControllingBundle
│   ├── ControllingBundle.php
|   └ ... more files and directories follow here ...

Clear cache

After uploading the files, Kimai needs to know about the new plugin. It will be found once the cache was re-built. Call these commands from the Kimai directory:

How to reload Kimai cache

bin/console kimai:reload --env=prod

FTP users: please have a look at this documentation.

If you are running an older version of Kimai (before 1.8) you have to use:

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

You might have to set file permissions afterwards:

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.


Updating the plugin works exactly like the installation:

  • Delete the directory var/plugins/ControllingBundle/
  • Execute all installation steps again:
    • Copy files
    • Clear cache