86 lines
3.1 KiB
Markdown
86 lines
3.1 KiB
Markdown
# Docker
|
|
|
|
The Dockerfile supplied with this application is development or demonstration docker. It runs a self contained version of kimai2 against a sqlite database in the docker container.
|
|
|
|
There is an official docker repo for the kimai app that includes the Docker file from this repo and a docker file suitable for running in a production environment.
|
|
|
|
* The docker repo: [https://github.com/tobybatch/kimai2](https://github.com/tobybatch/kimai2)
|
|
* That repo on dockerhub auto-building the prod and dev conatiners: [https://hub.docker.com/r/kimai/kimai2](https://hub.docker.com/r/kimai/kimai2).
|
|
|
|
Any issues with the container rather than the application itself should be raised [here](https://github.com/tobybatch/kimai2/issues).
|
|
|
|
## Build the docker
|
|
|
|
docker build -t kimai/kimai2:dev .
|
|
|
|
|
|
|
|
## Run the docker
|
|
|
|
```
|
|
docker run -ti -p 8001:8001 --name kimai2 --rm kimai/kimai2:dev
|
|
```
|
|
|
|
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
|
|
```
|
|
|
|
You can find Kimai at that IP on port 8001.
|
|
|
|
### Mac using docker-machine
|
|
|
|
When using dock-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
|
|
|
|
See the docs [here](installation.md) for full instructions, but this creates a user admin/admin with all privileges.
|
|
|
|
```
|
|
docker exec kimai2 bin/console kimai:create-user admin admin@example.com ROLE_SUPER_ADMIN admin
|
|
```
|
|
|
|
To install the fixtures:
|
|
|
|
```
|
|
docker exec kimai2 bin/console kimai:reset-dev
|
|
```
|
|
|
|
## Developing against the docker
|
|
|
|
It is possible to mount your source tree and sqlite DB into the container at run time. **N.B. The sqlite database needs to writable by the www-data user.** Use ```chown 33:33 kimai.sqlite``` on the host machine.
|
|
|
|
```
|
|
docker run --rm -d -p 8001:8001 \
|
|
-v $(pwd)/src:/opt/kimai/src \
|
|
-v $(pwd)/var/data/kimai.sqlite:/opt/kimai/var/data/kimai.sqlite \
|
|
--name kimai2 kimai/kimai2:dev
|
|
```
|
|
|
|
Now edits in the local file tree will be served by the container and database changes will persist.
|
|
|
|
See [The official docker documentation](https://docs.docker.com/) for more options on running the container.
|
|
|
|
## Further docker solutions
|
|
|
|
As there are several approaches to docker images, you have multiple docker images to choose from.
|
|
They were built by the community, we do not support them - for question please ask in their repositories:
|
|
|
|
- [dysonspherelab](https://hub.docker.com/r/dysonsphere/kimai2/) (for more infos [read this issue](https://github.com/kevinpapst/kimai2/issues/284))
|
|
- [felixhummel](https://github.com/felixhummel/kimai-in-docker/tree/kimai2)
|
|
- [Haidy777](https://github.com/Haidy777/kimai2/blob/docker/Dockerfile) (for more infos [read this issue](https://github.com/kevinpapst/kimai2/pull/311))
|