Kimai Documentation
Docker
Production docker
@tobybatch is managing the Kimai Docker images, both for development and a docker-compose setup suitable for running in a production environment.
- https://github.com/tobybatch/kimai2 - his repository with all the docker sources
- https://hub.docker.com/r/kimai/kimai2 - dockerhub repo, auto-building prod and dev containers
Any issues with the container rather than the application itself should be raised here.
Build the docker
docker build -t my-local-kimai .
Run the docker
docker run -ti -p 8001:8001 --name kimai2 --rm my-local-kimai
You can then access the site on http://127.0.0.1:8001. If that doesn’t work check the IP of your docker:
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' kimai2
Mac using docker-machine
When using docker-machine on your Mac, you need to use the IP of your machine.
Considering you started the machine named default, you find the IP with:
docker-machine ip default
Running commands in the docker
You can run any command in the container in this fashion once it is started. Add -ti to attach a terminal.
docker exec -ti kimai2 bash
Create a user and dummy data
This creates a user admin/password with all privileges.
docker exec kimai2 /opt/kimai/bin/console kimai:user:create admin admin@example.com ROLE_SUPER_ADMIN password
To install the test data (fixtures):
docker exec kimai2 /opt/kimai/bin/console kimai:reset:dev
Using a custom local.yaml
You can mount a custom configuration into the container while starting it:
docker run --rm -ti -p 8001:8001 --name kimai2 -v $(pwd)/config/packages/local.yaml:/opt/kimai/config/packages/local.yaml kimai/kimai2:dev
The official docker documentation has more options on running the container.