/docker-kimai

A docker image for Kimai time tracking based on the official php docker image.

Primary LanguageShellGNU Affero General Public License v3.0AGPL-3.0

docker-kimai

A docker image for Kimai time tracking based on the official php docker image.

This repository also contains a docker-compose.yaml configuration file for simple usage together with the official mariadb image.

Supported tags and respective Dockerfile links

Getting started

  1. Make sure you have current versions of Docker (>= 1.12) and docker-compose (>= 1.9).
  2. Clone this repository
  3. Create a docker volume named kimai-database:
$ docker volume create --name kimai-database
  1. Create and start the docker containers using docker-compose:
$ docker-compose up

This will command will:

  • Fetch the necessary docker images
  • Start the Apache and Mariadb services
  • Setup persistent configuration in the autoconf.php and auth.php

After completion, you should be able to access the Kimai instance but with an error at http://localhost:8080 (this is caused by the empty autoconf.php file which will be filled during the setup).

  1. To start the installation go to http://localhost:8080/installer/index.php and perform the initial installation. For the database connection choose the following parameters:

    • Host: database
    • User: kimai
    • Password: kimai
    • Database: kimai (Existing)

After you finished the installation, you should set the KIMAI_REMOVE_INSTALLATION environment variable to '1' (default is '0') in docker-compose.yaml:

    environment:
      - KIMAI_REMOVE_INSTALLATION=1

This deletes the installer/ directory on container start and prevents the warning after login.

Configuration

If you want to use LDAP authentication, you have to set the KIMAI_AUTHENTICATOR variable to ldap or ldapadvanced as discribed in the Kimai authentication documentation. And set your additional configuration in the auth.php accordingly.