kimai /kimai

Kimai is the #1 open-source time-tracking application. From freelancers to companies and organisations - everyone can manage timesheets, generate reports, create invoices and so much more... Web-based multi-user application, available as On-Premise or SaaS version: https://www.kimai.org

★ 5,165⑂ 888👁 61⑃ 1,975● 2,815▤ 196
PHPAGPL-3.0Created 2016-10-20www.kimai.org
Download: 2.72.02.72.0 ↓2.72.02026-11-13
+2
Daily
5,165
stars
888
forks
61
watchers
1,975
prs
2,815
issues
196
releases

README

Kimai1 Open-Source Time-Tracker

Kimai is a professional grade time-tracking application, free and open-source. 
It handles use-cases of freelancers as well as companies with dozens or hundreds of users. 
Kimai was build to track your project times and ships with many advanced features, including but not limited to:

JSON API, invoicing, data exports, multi-timer and punch-in punch-out mode, tagging, multi-user - multi-timezones - multi-language (over 30 translations existing!),
authentication via SAML/LDAP/Database, two-factor authentication (2FA) with TOTP, customizable role and team permissions, responsive design,
user/customer/project specific rates, advanced search & filtering, money and time budgets, advanced reporting, support for plugins
and so much more.

 Links

- Home — Kimai project homepage
- Blog — Read the latest news
- Documentation — Learn how to use Kimai
- Newsletter - Subscribe and get notified about new releases and important updates

 Requirements

- PHP 8.2 minimum with support for 8.3, 8.4, 8.5
- MariaDB / MySQL: oldest maintained LTS release (MariaDB = 10.6 or MySQL = 8.4) or newer
- A webserver and subdomain (subdirectory is not supported)
- PHP extensions: gd, intl, json, mbstring, pdo, tokenizer, xml, xsl, zip

 Installation

- Caddy with Docker-Compose at Hetzner and DigitalOcean
- SSH setup with Git and Composer
- Docker images with FPM only or incl. Apache
- Synology user can host the Docker version 
- Developer setups if you want to create Kimai integrations

There are more documented ways for on-premise hosting. 

And if you don't want to host Kimai, you can use the Cloud version of it.

 Updating Kimai

- Update Kimai — get the latest version
- UPGRADING guide — version specific steps

 Plugins

- Plugins — paid and free plugin marketplace
- Developer documentation — how to create a plugin

 Roadmap and releases

You can see a rough development roadmap, which is open for changes and input from the community, your ideas are welcome.

Release versions will be created on a regular basis, every couple of weeks latest.

 Contributing

You want to contribute to this repository? This is so great!
The best way to start is to open a bug report or feature request or a discussion for questions, support and such.

In case you want to contribute, but you wouldn't know how, here are some suggestions:

- Spread the word: Please write a testimonial for our Wall of love, vote for Kimai on any software platform, you can toot or tweet about it, share it on LinkedIn, Reddit and any other social media platform!
- Translate Kimai into your language, or help to improve the existing translations, many languages look for a contributor
- Answer questions: You know the answer to another user's problem? Share your knowledge.
- Something can be done better? An essential feature is missing? Create a feature request.
- Report bugs makes Kimai better for everyone.
- You don't have to be programmer, the documentation and translation could always

Top issues

Discussions

Latest release

2.72.0 2.72.0 2026-11-13
Compatible with PHP 8.2 to 8.5

 Features & Maintenance

- Bump Docker to PHP 8.5, use custom ICU data to fix timezone issues in some countries (6318)
- Search invoice history by invoice number (6287) - thanks @Deniiz23 
- Highlight unpaid invoices in listings
- Run the search on Enter instead of saving the filter as default (invoice & export screen) (6291) - thanks @dgesteves 
- Run pnpm lint during CI
- Updated translations (6292) (6306)
- Fix twig deprecations: missing default parameter in macros
- Improved invoice overdue calculation (internal API bug, no visible changes)
- Bum

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON