Sign inSign up

mplx/docker-kimai

By mplx

•Updated over 6 years ago

Alpine Linux based Docker container with NGINX webserver and Kimai2 Time Tracker.

Image
1

2.5K

mplx/docker-kimai repository overview

⁠Kimai on Docker

Alpine Linux based Docker container with NGINX webserver and Kimai2 Time Tracker⁠.

WORK IN PROGRESS!

⁠Docker Hub⁠ Version Tag

TagDescription
x.y.z⁠images matching git tags; semantic versioning
latestbuild with latest semver tag
masterbuild from latest commit in master branch

⁠Run

docker run --rm --name kimai -p 8080:8080 -v data:/home/project/kimai2/var/data/ --env-file kimai.env mplx/kimai

⁠Environment Variables

VariableDescriptionSample⁠ Value
DATABASE_URLDatabase connection URIsqlite:///%kernel.project_dir%/var/data/kimai.sqlite
APP_SECRETSymfony application secretchangeme
TRUSTED_PROXIESKimai trusted proxiesfalse
TRUSTED_HOSTSKimai trusted hostsfalse
MAILER_FROMMail-From[email protected]⁠
MAILER_URLMail server URInull://localhost
INSTALL_ADMINUSER*Superadmin⁠: usernamesuperadmin
INSTALL_ADMINPASS*Superadmin: passwordchangeme
INSTALL_ADMINMAIL*Superadmin: email address[email protected]⁠
INSTALL_PLUGIN_nnninstall plugin (see below)true
ALLOW_USER_REGallow registration of new usersfalse
TZTime Zone⁠Atlantic/Canary

(*) only valid on first run (fresh installation scenario)

⁠Bundled Plugins

VariablePlugin
INSTALL_PLUGIN_EASYBACKUPBUNDLEEasyBackupBundle⁠
INSTALL_PLUGIN_CUSTOMCSSBUNDLECustomCSSBundle⁠
INSTALL_PLUGIN_READONLYACCESSBUNDLEReadOnlyAccessBundle⁠
INSTALL_PLUGIN_RECALCULATERATESBUNDLERecalculateRatesBundle⁠
INSTALL_PLUGIN_EMPTYDESCRIPTIONCHECKERBUNDLEEmptyDescriptionCheckerBundle⁠
  • If you need to install other plugins than the ones bundled you'll need to map the var/plugins/ outside the container (.ie. -v plugins:/home/project/kimai2/var/plugins).
  • The plugin will only get installed/enabled if the plugin directory currently does not exist (i.e. you mapped the plugin directory outside the container and installed it yourself).
  • An already installed plugin (i.e. you mapped the plugin directory) won't get removed if you set this option to false.

⁠Volumes

DirectoryDescription
/home/project/kimai2/var/data/Data(base)
/home/project/kimai2/var/log/Symfony prod.log
/home/project/kimai2/var/plugins/Kimai2 Plugins
/home/project/kimai2/var/easy_backup/Default EasyBackup Target Directory
  • Even if you don't use sqlite it's recommended to persist .../var/data as it might get usefull for further updates.
  • You also can map the full /home/project/kimai2/var/ however this would include the Symfony Cache, PHP Sessions, etc. aswell.

⁠Contributing Guidelines

Contributions welcome! When submitting your first pull request please add your author email (the one you use to make commits) to the contributors⁠ file which contains a Contributor License Agreement (CLA).

⁠License

Licensed under MIT License⁠.

Tag summary

Content type

Image

Digest

Size

259.7 MB

Last updated

over 6 years ago

docker pull mplx/docker-kimai