From c5a20eb5219502a0449b4d0c62eb6d20873f90b9 Mon Sep 17 00:00:00 2001 From: andryyy Date: Tue, 20 Oct 2020 15:42:18 +0200 Subject: [PATCH] Add Dovecot master instructions --- docs/u_e-dovecot-static_master.md | 21 +++++++++++++++++++++ mkdocs.yml | 7 ++++--- 2 files changed, 25 insertions(+), 3 deletions(-) create mode 100644 docs/u_e-dovecot-static_master.md diff --git a/docs/u_e-dovecot-static_master.md b/docs/u_e-dovecot-static_master.md new file mode 100644 index 000000000..99503572b --- /dev/null +++ b/docs/u_e-dovecot-static_master.md @@ -0,0 +1,21 @@ +Random master usernames and passwords are automatically created on every restart of dovecot-mailcow. + +**That's recommended and should not be changed.** + +If you need the user to be static anyway, please specify two variables in `mailcow.conf`. + +**Both** parameters must not be empty! + +``` +DOVECOT_MASTER_USER=mymasteruser +DOVECOT_MASTER_PASS=mysecretpass +``` + +Run `docker-compose up -d` to apply your changes. + +The static master username will be expanded to `DOVECOT_MASTER_USER@mailcow.local`. + +To login as `test@example.org` this would equal to `test@example.org*mymasteruser@mailcow.local` with the specified password above. + +A login to SOGo is not possible with this username. A click-to-login function for SOGo is available for admins as described [https://mailcow.github.io/mailcow-dockerized-docs/debug-admin_login_sogo/](here). +No master user is required. diff --git a/mkdocs.yml b/mkdocs.yml index bfad849f2..ac539bb05 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,14 +79,15 @@ nav: - 'Using an external DNS service': 'u_e-unbound-fwd.md' - 'Dovecot': - 'Enable "any" ACL settings': 'u_e-dovecot-any_acl.md' - - 'Public folders': 'u_e-dovecot-public_folder.md' - 'Expunge a Users mails': 'u_e-dovecot-expunge.md' - 'Customize/Expand dovecot.conf': 'u_e-dovecot-extra_conf.md' + - 'FTS (Solr)': 'u_e-dovecot-fts.md' + - 'IMAP IDLE interval': 'u_e-dovecot-idle_interval.md' - 'Mail crypt': 'u_e-dovecot-mail-crypt.md' - 'More Examples with DOVEADM': 'u_e-dovecot-more.md' - 'Move vmail volume': 'u_e-dovecot-vmail-volume.md' - - 'IMAP IDLE interval': 'u_e-dovecot-idle_interval.md' - - 'FTS (Solr)': 'u_e-dovecot-fts.md' + - 'Public folders': 'u_e-dovecot-public_folder.md' + - 'Static master user': 'u_e-dovecot-static_master.md' - 'Nginx': - 'Custom sites': 'u_e-nginx.md' - 'Create subdomain webmail.example.org': 'u_e-webmail-site.md'