README.md

Roundcubemail for dokku

Simple dokku configuration wrapper for the upstream official roundcubemail image.

This just ensures that the dokku linked container variables are converted to the expected upstream environment variables.

Environment configuration

All ROUNDCUBEMAIL_<var> env vars are set to $config[strtolower('<var>')].

i.e.

ROUNDCUBEMAIL_TEST=1

will be

$config['test'] => '1';

If the value can be json decoded to an (assoc) array then this will used as the value.

i.e.

ROUNDCUBEMAIL_ARRAY_VAR="[1,2,3]"
ROUNDCUBEMAIL_ASSOC_VAR="{\"key\":\"value\"}"

will be

$config['array_var'] = [1,2,3];
$config['assoc_var'] = ['key' => 'value'];

Link database container (optional)

Requires mysql plugin / mariadb plugin

Note: if using mariadb replace mysql with mariadb in commands

dokku mysql:create <name>
dokku mysql:link <name> <app>

DATABASE_URL is used for configuration value db_dsnw

Link memcached container (optional)

Requires memcached plugin

dokku memcached:create <name>
dokku memcached:link <name> <app>

MEMCACHED_URL is used for memcache_hosts configuration.

Link redis container (optional)

Requires redis plugin

dokku redis:create <name>
dokku redis:link <name> <app>

REDIS_URL is used for redis_hosts configuration.

Mount for temp storage (optional)

dokku storage:mount <app> <host-dir>:/tmp/roundcube-temp

Mount for SQLite DB (optional)

If using the built in SQLite and you want to persist the database then add a mount to /var/www/html/db.

dokku storage:mount <app> <host-dir>:/var/www/html/db