menardorama/docker-cheky repository overview

⁠docker-cheky

This a fork of skurtzemann/docker-cheky. It's just a more up to date version.

Automated build using travis CI

Dockerize version of Cheky⁠.

⁠Usage

⁠Basic usage

Simply run the docker image and expose the port 80:

$ docker run -d --name=cheky -p 80:80 menardorama/docker-cheky:latest

⁠Persistent data

To persist Cheky configuration you can bind mount a docker volume to /var/www/html/var/.

$ docker run -d --name=cheky -p 80:80 -v <host_cheky_data_dir>:/var/www/html/var/  menardorama/docker-cheky:latestv

⁠Notes

• This image use the files storage type.

⁠Environment Variables

Some Cheky settings can be customize with environments variables.

⁠Application access

⁠CHEKY_BASEURL

Set the Checky base URL.

• Example :

  CHEKY_BASEURL=http://cheky.example.com
  

  Copy

• The default base URL is http://cheky.local.

⁠Admin password

Set the admin password.

• The default password is admin.

The admin password can be set in plain test or with it SHA1 checksum.

⁠CHEKY_ADMIN_PASSWORD

Set the password in plain text.

⁠CHEKY_ADMIN_PASSWORD_SHA1

Set the password with it SHA1 checksum.

To generate the SHA1 checksum you can use the sha1sum command.

• For example for the plain text password test:

$ echo -n "test" | sha1sum | cut -d" " -f1
a94a8fe5ccb19ba61c4c0873d391e987982fbbd3

⁠Mailer configuration

Configure the mailer for alerts.

⁠CHEKY_CONFIG_MAILER

Disable/enable the mailer configuration : 0|1

• The default value is 0.

⁠CHEKY_MAILER_SMTP_HOST

Set the SMTP hostname.

⁠CHEKY_MAILER_SMTP_PORT

Set the SMTP port.

⁠CHEKY_MAILER_SMTP_USERNAME

Set the SMTP username.

⁠CHEKY_MAILER_SMTP_PASSWORD

Set the SMTP password.

⁠CHEKY_MAILER_SMTP_SECURE

Set the SMTP connection security : <empty>|tls|ssl

⁠CHEKY_MAILER_FROM

Set the sender email for Cheky alerts.

• SMTP configuration example:

  CHEKY_MAILER_SMTP_HOST=smtp.mailgun.org
  CHEKY_MAILER_SMTP_PORT=587
  CHEKY_MAILER_SMTP_USERNAME=xxx
  CHEKY_MAILER_SMTP_PASSWORD="yyy"
  CHEKY_MAILER_SMTP_SECURE=tls
  [email protected]
  

  Copy

⁠Check cronjob

⁠CHEKY_CRON_INTERVAL

Set the cron interval for the Cheky check cronjob⁠.

• Example :

  CHEKY_CRON_INTERVAL="*/5 * * * *"
  

  Copy

• The default value is */30 * * * *.