roundcube #0
Description
RoundCube Webmail is a browser-based multilingual IMAP client with an application-like user interface. It provides full functionality expected from an e-mail client, including MIME support, address book, folder manipulation and message filters. The user interface is fully skinnable using XHTML and CSS 2.
- Tags:
- applications ›
Juju charm Roundcube author: Nick Barcet nick.barcet@canonical.com
Usage
- Setup your site specific parameters in roundcube.yaml
vi roundcube.yaml
A list of all settable parameter with description is available using
juju get roundcube
or listing config.yaml
-
Deployment with mysql and haproxy
juju bootstrap juju deploy --config roundcube.yaml roundcube juju deploy mysql juju deploy haproxy juju add-relation mysql roundcube juju add-relation roundcube haproxy juju expose haproxy
-
Accessing your new roundcube site should be ready at http://[haproxy-machine-addr]/. To find out the public address of haproxy, look for it in the output of the 'juju status' command.
Note about HTTPS
to enable https access to your site, you can set "do_https" to the value of the https port you want to listen to (443 is the default for https). You will also need to provide the paths to existing SSLCertificate (ssl_crt) and key (ssl_key). This means that you will have to use juju scp to upload your certificates before making the config changes and adding other units.
You can also use the default ssl snake oil certificates provided by the ssl-cert package:
# This config activates https on port 443
do_https: 443
ssl_crt: /etc/ssl/certs/ssl-cert-snakeoil.pem
ssl_key: /etc/ssl/private/ssl-cert-snakeoil.key
If the certificate you provide is invalid, apache will fail to load. If the paths you provide are invalid, the https site will no be activated.
juju debug-log
should be your friend, go have a look.
The certificates should be uploaded to the first unit you start, a peer relation between all units will ensure that they will be reused identically everywhere.
Configuration
- db_max_length
- (int) maximum length of a query in bytes
- 512000
- db_persistent
- (boolean) use persistent db-connections
- default_host
- (string) IMAP mail host chosen to perform the log-in
- imap.domain.tld
- default_port
- (int) IMAP server port
- 143
- do_https
- (int) Will setup apache with ssl vhost on the port value specified if different from 0 (default ssl port is 443)
- force_https
- (boolean) with this option enabled, all non-secure connections will be redirected. set the port for the ssl connection as value of this option if it differs from the default 443
- optimize_http
- (int) enables mod_deflate, mod_headers and mod_expires as recommended for production use.
- 1
- smtp_pass
- (string) SMTP password (if required) if you use %p as the password Roundcube will use the current user's password for login
- %p
- smtp_port
- (int) SMTP port.
- 25
- smtp_server
- (string) SMTP mail host to send emails
- smtp.server.tld
- smtp_user
- (string) SMTP username (if required) if you use %u as the username Roundcube will use the current username for login
- %u
- ssl_crt
- (string) Full path (in the running unit) of the certificate file that Apache will use for https. The file needs to be placed using the juju scp command.
- ssl_key
- (string) Full path (in the running unit) of the certificate key file that Apache will use for https. The file needs to be placed using the juju scp command.
- use_https
- (boolean) tell PHP that it should work as under secure connection even if it doesn't recognize it as secure ($_SERVER['HTTPS'] is not set) e.g. when you're running Roundcube behind a https proxy