You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
roundcubemail/docker/README.md

2.1 KiB

Running Roundcube in a Docker Container

The simplest method is to run the official image:

docker run -e ROUNDCUBEMAIL_DEFAULT_HOST=mail -d roundcube/roundcubemail

Configuration/Environment Variables

The following env variables can be set to configure your Roundcube Docker instance:

ROUNDCUBEMAIL_DEFAULT_HOST - Hostname of the IMAP server to connect to

ROUNDCUBEMAIL_DEFAULT_PORT - IMAP port number; defaults to 143

ROUNDCUBEMAIL_SMTP_SERVER - Hostname of the SMTP server to send mails

ROUNDCUBEMAIL_SMTP_PORT - SMTP port number; defaults to 587

ROUNDCUBEMAIL_PLUGINS - List of built-in plugins to activate. Defaults to archive,zipdownload

By default, the image will use a local SQLite database for storing user account metadata. It'll be created inside the /var/www/html volume and can be backed up from there. Please note that this option should not be used for production.

Connect to a MySQL Database

The recommended way to run Roundcube is connected to a MySQL database. Specify the following env variables to do so:

MYSQL_ENV_MYSQL_HOST - Host (or Docker instance) name of the MySQL service; defaults to mysql

MYSQL_ENV_MYSQL_USER - The database username for Roundcube; defaults to root

MYSQL_ENV_MYSQL_PASSWORD - The password for the database connection or MYSQL_ENV_MYSQL_ROOT_PASSWORD - if the database username is root

MYSQL_ENV_MYSQL_DATABASE - The database name for Roundcube to use; defaults to roundcubemail

Before staring the container, please make sure that the supplied database exists and the given database user has privileges to create tables.

Run it with a link to the MySQL host and the username/password variables:

docker run -e MYSQL_ENV_MYSQL_ROOT_PASSWORD=my-secret-password --link=mysql:mysql -d roundcube/roundcubemail

Building a Docker Container

Use the Dockerfile in this directory to build you own Docker image. It pulls the latest build of Roundcube Webmail from the Github download page and builds it on top of a php:7.1-apache Docker image.

Build it from this directory with

docker build -t roundcubemail