Skip to content

Cachet stack documentation

Cachet can be configured with the following environment variables

Mail delivery

No delivery guarantee

If you're using a server from a public cloud there's a good chance that its IP is already compromised and blacklisted by major mail services, hence your emails will not be delivered or will land in the spam folder. We strongly recommend using OpenSMTPD in pair with a third-party SMTP services.

Cron

By default we run the following cron command from crond container every hour:

/usr/local/bin/php -q ./artisan schedule:run

Containers

PHP

  • PHP can be configured with the following environment variables
  • Available php extensions
  • Composer pre-installed with a default global package hirak/prestissimo:^0.3 to download dependencies in parallel

Files directory permissions

Public files directory (symlink to /mnt/files/public) that used for uploads owned by www-data user (PHP-FPM user) by default and the default container user (wodby) has no writing permissions. So if you run a command that creates files in a public directory you will get insufficient permissions error. You can fix this problem by giving writing permissions for files directory to the owner's group (user wodby is a member of www-data group) by using one of the helper scripts:

sudo files_chmod /mnt/files/public

For mode details about users and permissions in PHP container see https://github.com/wodby/php#users-and-permissions

Environment variables

Variables availability

Environment variables provided by Wodby are always available in PHP even if PHP_FPM_CLEAR_ENV set to no.

In addition to global environment variables, we provide the following variables in PHP container that you can use in your post-deployment scripts or settings files:

Variable Description
$APP_ROOT /var/www/html by default
$HTTP_ROOT e.g. /var/www/html/web
$CONF_DIR /var/www/conf by default
$WODBY_APP_NAME My app
$WODBY_HOST_PRIMARY example.com
$WODBY_URL_PRIMARY http://example.com
$WODBY_HOSTS [ "example.com", "dev.example.org.wod.by" ]

Deprecated variables:

Variable Instead use
$WODBY_APP_ROOT $APP_ROOT
$WODBY_APP_DOCROOT $HTTP_ROOT
$WODBY_CONF $CONF_DIR
$WODBY_DIR_CONF $CONF_DIR

Crond

A duplicate of the main PHP container runs with crond (instead of FPM). You can customize crontab from [Instance] > Stack > Settings page.

OpenSMTPD

PostgreSQL

Redis

Changelog

1.1.1

  • Cachet updated to 2.3.5
  • Cachet image rebased to latest wodby/php image
  • Added Nginx 1.14, 1.15
  • PostgreSQL
    • Version 10 added
    • Version 9.6 updated to 9.6.9
  • PHP error reporting now exludes strict and deprecated errors

1.1.0

  • Nginx image wodby/cachet-nginx replaced with wodby/php-nginx
  • Now when your upgrade stack with a new version of Cachet, your source code will be updated
  • Default memory request set to:
    • Cachet: 64m
    • Crond: 4m
    • PostgreSQL: 64m
    • Redis: 4m
    • OpenSMTPD: 64m

1.0.1

1.0.0

Initial release