diff --git a/src/content/docs/ispmail-trixie/170-webmail.mdx b/src/content/docs/ispmail-trixie/170-webmail.mdx index 423237a..57c1044 100644 --- a/src/content/docs/ispmail-trixie/170-webmail.mdx +++ b/src/content/docs/ispmail-trixie/170-webmail.mdx @@ -126,10 +126,18 @@ email address as the user name. E.g. `john@example.org` and password `summersun` If the login fails, check `/var/log/roundcube/errors.log`. + + ## Plugins -Roundcube comes with various plugins that you can offer your users. I suggest that you enable at least the **password** -plugin so that your users can change their access password. +Roundcube comes with various plugins that you can offer your users. I suggest that you enable at least + +- the **password** plugin so that your users can change their access password +- the **managesieve** plugin so that your users can create server-based filtering rules Again edit the `/etc/roundcube/config.inc.php` file and look for the _plugins_ configuration. To enable the recommended plugins change it to: @@ -141,8 +149,11 @@ $config['plugins'] = array( ); ``` -Plugins are configured through files located in the `/etc/roundcube/plugins` directory. Let's quickly set up the -password plugin: +Plugins are configured through files located in the `/etc/roundcube/plugins` directory. + +### password + +Let's quickly set up the password plugin: ```sh title="Run this on your server" cat > /etc/roundcube/plugins/password/config.inc.php << 'EOF' @@ -161,7 +172,7 @@ chown root:www-data /etc/roundcube/plugins/password/config.inc.php chmod u=rw,g=r,o= /etc/roundcube/plugins/password/config.inc.php ``` -Let’s briefly cover the meaning of those lines: +What these settings mean: - `$config['password_driver'] = 'sql';`\ Use SQL as a backend. @@ -191,8 +202,32 @@ Try it. Log into Roundcube as `john@example.org` with password ‘summersun’. Enter a new password twice. You should get a success message at the bottom right. Now logout and login with the new password. Does it work? Great. - +The configuration file for Roundcube’s _managesieve_ plugin is found at +`/etc/roundcube/plugins/managesieve/config.inc.php`. But the defaults are fine so you do not need to change it. + +Sieve rules are stored in a special syntax on the server. This is an example that moves all incoming emails to the +_test_ folder that have “test” in the subject: + +``` +require ["fileinto"]; +if header :contains "subject" "test" +{ + fileinto "INBOX/test"; +} +``` + +You do not need to learn this syntax though. Roundcube’s sieve rule editor is way more user-friendly. + +Try adding a sieve rule for `john@example.org` in Roundcube. That feature is located in Settings/Filters. You will find +the machine-readable sieve code at `/var/vmail/example.org/john/sieve/roundcube.sieve`. + +The rule editor looks like this: + +![Roundcube's sieve rule editor](images/webmail-roundcube-sieve-editor.png) diff --git a/src/content/docs/ispmail-trixie/images/webmail-roundcube-sieve-editor.png b/src/content/docs/ispmail-trixie/images/webmail-roundcube-sieve-editor.png new file mode 100644 index 0000000..1c89758 Binary files /dev/null and b/src/content/docs/ispmail-trixie/images/webmail-roundcube-sieve-editor.png differ