bibop182 / kimai2

Kimai v2 is a web-based multiuser time-tracking application. Free for everyone: freelancers, agencies, companies, organizations - all can track their times, generate invoices and more. SaaS version available at https://www.kimai.cloud

Kimai 2 - online time-tracker

Kimai is a free, open source and online time-tracking software designed for small businesses and freelancers. It is built with modern technologies such as Symfony, Bootstrap, RESTful API, Doctrine, AdminLTE, Webpack, ES6 etc.

Introduction

• Home - The house of Kimai
• Blog - Get the latest news
• Documentation - Learn how to use
• Translations - Kimai in your language
• Migration - Import data from v1

Requirements

• PHP 7.2.9 or higher
• Database (MySQL/MariaDB, SQLite for development)
• Webserver (nginx, Apache)
• A modern browser
• Other libraries

About

This is the new version of the open source timetracker Kimai. It is stable and production ready, ships with most advanced features from Kimai 1 and many new ones, including but not limited to:

JSON API, invoicing, data exports, multi-timer and punch-in punch-out mode, tagging, multi-user and multi-timezones, authentication via SAML/LDAP/Database, customizable role permissions, responsive and ready for your mobile device, user specific rates, advanced search & filtering, money and time budgets with report, support for plugins and many more.

Installation

• Recommended setup - with Git and Composer
• Docker - containerized
• Development - on your local machine
• 1-click installer - hosted environments
• FTP - unfortunately still widely used ;-)

Updating Kimai

• Update Kimai - the documentation
• UPGRADING guide - version specific steps

Plugins

• Plugin marketplace - find existing plugins here
• Developer documentation - how to create a plugin

Roadmap and releases

You can see a rough development roadmap in the Milestones sections. It is open for changes and input from the community, your ideas and questions are welcome.

Kimai 2 uses a rolling release concept for delivering updates. You can upgrade Kimai at any time , you don't need to wait for the next official release.

Release versions will be created on a regular base (approx. one release per month) and you should use these tags if you are not familiar with git. Every code change, whether it's a new feature or a bug fix, will be done on the master branch. I develop Kimai in my free time and want to put my effort into the software instead of backporting changes for old versions. The only exception is a critical security issue, which I would fix in the last version as well.

Credits

Kimai 2 is developed with modern frameworks like Symfony v4, Doctrine, AdminLTEBundle (based on AdminLTE theme) and many more.