kimai/kimai2 repository overview

⁠Kimai - the #1 Open-Source time-tracker

We provide a set of docker images for the Kimai time-tracking⁠ application (Github⁠). Use the SaaS version⁠ if you prefer a system that is hosted for you.

Subscribe to the Self-Host newsletter⁠ to get notified about new releases and important updates.

⁠Available tags

Please read the documentation⁠ before choosing a tag.

⁠Quick start

Run the latest production build:

1. Start a DB

       docker run --rm --name kimai-mysql-testing \
           -e MYSQL_DATABASE=kimai \
           -e MYSQL_USER=kimai \
           -e MYSQL_PASSWORD=kimai \
           -e MYSQL_ROOT_PASSWORD=kimai \
           -p 3399:3306 -d mysql
   

   Copy

2. Start Kimai

       docker run --rm --name kimai-test \
           -ti \
           -p 8001:8001 \
           -e DATABASE_URL=mysql://kimai:[email protected]:3399/kimai \
           --add-host=host.docker.internal:host-gateway \
           kimai/kimai2:apache
   

   Copy

3. Add a user using the terminal

       docker exec -ti kimai-test \
           /opt/kimai/bin/console \
           kimai:user:create admin [email protected] ROLE_SUPER_ADMIN
   

   Copy

Now, you can access the Kimai instance at http://localhost:8001⁠.

Note: If you're using Docker for Windows or Docker for Mac, and you're getting "Connection refused" or other errors, you might need to change ${HOSTNAME} to host.docker.internal. This is because the Kimai Docker container can only communicate within its network boundaries. Alternatively, you can start the container with the flag --network="host". See here⁠ for more information.

Keep in mind that this Docker setup is transient and the data will disappear when you remove the containers.

    docker stop kimai-mysql-testing kimai-test
    docker rm kimai-mysql-testing kimai-test

⁠Documentation

We have further documentation, also on topics like Docker⁠, Docker-Compose⁠ and Kubernetes⁠ available.