diff options
author | Guillaume Girol <symphorien+git@xlumurb.eu> | 2021-12-31 12:00:00 +0000 |
---|---|---|
committer | lewo <lewo@abesis.fr> | 2022-02-26 17:06:52 +0000 |
commit | 7de138037f62679e2fefa0549af543412dab0d1a (patch) | |
tree | 799f7ee3aa43dd0d2f45d5c03a080882998e3e25 | |
parent | 021b5c8f7346aad37ba7f208408b1fb11b3b5f88 (diff) |
docs: add how-to to setup roundcube
-rw-r--r-- | docs/add-roundcube.rst | 32 | ||||
-rw-r--r-- | docs/index.rst | 1 |
2 files changed, 33 insertions, 0 deletions
diff --git a/docs/add-roundcube.rst b/docs/add-roundcube.rst new file mode 100644 index 0000000..08e41ed --- /dev/null +++ b/docs/add-roundcube.rst @@ -0,0 +1,32 @@ +Add Roundube, a webmail +======================= + +The NixOS module for roundcube nearly works out of the box with SNM. By +default, it sets up a nginx virtual host to serve the webmail, other web +servers may require more work. + +.. code:: nix + + { config, pkgs, lib, ... }: + + with lib; + + { + services.roundcube = { + enable = true; + # this is the url of the vhost, not necessarily the same as the fqdn of + # the mailserver + hostName = "webmail.example.com"; + extraConfig = '' + # starttls needed for authentication, so the fqdn required to match + # the certificate + $config['smtp_server'] = "tls://${config.mailserver.fqdn}"; + $config['smtp_user'] = "%u"; + $config['smtp_pass'] = "%p"; + ''; + }; + + services.nginx.enable = true; + + networking.firewall.allowedTCPPorts = [ 80 443 ]; + } diff --git a/docs/index.rst b/docs/index.rst index 262c664..b8700ff 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -25,6 +25,7 @@ Welcome to NixOS Mailserver's documentation! backup-guide add-radicale + add-roundcube rspamd-tuning fts flakes |