site_name: 'mailcow: dockerized documentation'
site_url: https://mailcow.github.io/mailcow-dockerized-docs/
copyright: 'Copyright © 2020 André Peters'
repo_name: mailcow/mailcow-dockerized
repo_url: https://github.com/mailcow/mailcow-dockerized
edit_uri: ../mailcow-dockerized-docs/edit/master/docs/
remote_branch: gh-pages
theme: material
markdown_extensions:
  - codehilite:
      guess_lang: true
  - toc:
      permalink: true
  - admonition
  - pymdownx.magiclink
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.mark
  - pymdownx.tilde
  - pymdownx.extra
  - footnotes
nav:
- 'Information & Support': 'index.md'
- 'Prerequisites':
  - 'Prepare your system': 'prerequisite-system.md'
  - 'DNS setup': 'prerequisite-dns.md'
- 'Installation, Update & Migration':
  - 'Installation': 'i_u_m_install.md'
  - 'Update': 'i_u_m_update.md'
  - 'Migration': 'i_u_m_migration.md'
- 'First Steps (optional)':
  - 'Untrust RFC 1918': 'firststeps-rfc-1918.md'
  - 'Advanced SSL': 'firststeps-ssl.md'
  - 'Rspamd UI': 'firststeps-rspamd_ui.md'
  - 'Reverse Proxy': 'firststeps-rp.md'
  - 'SNAT': 'firststeps-snat.md'
  - 'Disable IPv6': 'firststeps-disable_ipv6.md'
  - 'Relayhosts': 'firststeps-relayhost.md'
  - 'Logging': 'firststeps-logging.md'
  - 'Local MTA on Docker host': 'firststeps-local_mta.md'
  - 'Sync job migration': 'firststeps-sync_jobs_migration.md'
  - 'IP bindings': 'firststeps-ip_bindings.md'
- 'Models':
  - 'ACL': 'model-acl.md'
  - 'Password hashing': 'model-passwd.md'
  - 'Sender and receiver model': 'model-sender_rcv.md'
  - 'WebAuthn / FIDO2': 'model-fido2.md'
- 'Debugging & Troubleshooting':
    - 'Introduction': debug.md
    - 'Logs': 'debug-logs.md'
    - 'Attach a Container': 'debug-attach_service.md'
    - 'Reset Passwords (incl. SQL)': 'debug-reset_pw.md'
    - 'Manual MySQL upgrade': 'debug-mysql_upgrade.md'
    - 'Remove Persistent Data': 'debug-rm_volumes.md'
    - 'Common Problems': 'debug-common_problems.md'
    - 'Admin login to SOGo': 'debug-admin_login_sogo.md'
- 'Backup & Restore':
  - 'Helper script':
      - 'Backup': 'b_n_r_backup.md'
      - 'Restore': 'b_n_r_restore.md'
  - 'Manually':
      - 'Maildir': 'u_e-backup_restore-maildir.md'
      - 'MySQL': 'u_e-backup_restore-mysql.md'
- 'Usage & Examples':
  - 'mailcow UI':
      - 'Configuration': 'u_e-mailcow_ui-config.md'
      - 'Blacklist / Whitelist': 'u_e-mailcow_ui-bl_wl.md'
      - 'Pushover': 'u_e-mailcow_ui-pushover.md'
      - 'Spamfilter': 'u_e-mailcow_ui-spamfilter.md'
      - 'Temporary email aliases': 'u_e-mailcow_ui-spamalias.md'
      - 'Tagging': 'u_e-mailcow_ui-tagging.md'
      - 'Two-Factor Authentication': 'u_e-mailcow_ui-tfa.md'
  - 'Postfix':
      - 'Custom transport maps': 'u_e-postfix-custom_transport.md' 
      - 'Whitelist IP in Postscreen': 'u_e-postfix-postscreen_whitelist.md'
      - 'Customize/Expand main.cf': 'u_e-postfix-extra_cf.md'
      - 'Disable Sender Addresses Verification': 'u_e-postfix-disable_sender_verification.md'
      - 'Max. message size (attachment size)': 'u_e-postfix-attachment_size.md'
      - 'Statistics with pflogsumm': 'u_e-postfix-pflogsumm.md'
  - 'Unbound':
      - 'Using an external DNS service': 'u_e-unbound-fwd.md'
  - 'Dovecot':
      - 'Enable "any" ACL settings': 'u_e-dovecot-any_acl.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'
      - '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'
  - 'Redis': 'u_e-redis.md'
  - 'Rspamd': 'u_e-rspamd.md'
  - 'SOGo': 'u_e-sogo.md'
  - 'Docker':
      - 'Customize Dockerfiles': 'u_e-docker-cust_dockerfiles.md'
      - 'Docker Compose Bash Completion': 'u_e-docker-dc_bash_compl.md'
  - 'Why unbound?': 'u_e-why_unbound.md'
  - 'Autodiscover / Autoconfig': 'u_e-autodiscover_config.md'
  - 'Redirect HTTP to HTTPS': 'u_e-80_to_443.md'
  - 'Adjust Service Configurations': 'u_e-change_config.md'
  - 'Deinstall': 'u_e-deinstall.md'
  - 'Re-enable TLS 1.0 and TLS 1.1': 'u_e-reeanble-weak-protocols.md'
  - 'Mailpiler Integration': 'u_e-mailpiler-integration.md'
  - 'Exchange Hybrid Setup': 'u_e-exchange-onprem.md'
- 'Client Configuration':
  - 'Overview': 'client.md'
  - 'Android': 'client/client-android.md'
  - 'Apple macOS / iOS': 'client/client-apple.md'
  - 'eM Client': 'client/client-emclient.md'
  - 'KDE Kontact': 'client/client-kontact.md'
  - 'Microsoft Outlook': 'client/client-outlook.md'
  - 'Mozilla Thunderbird': 'client/client-thunderbird.md'
  - 'Windows Mail': 'client/client-windows.md'
  - 'Windows Phone': 'client/client-windowsphone.md'
  - 'Manual configuration': 'client/client-manual.md'
- 'Third party apps':
  - 'SOGo Connector for Thunderbird': 'third_party-thunderbird.md'
  - 'Roundcube': 'third_party-roundcube.md'
  - 'Portainer': 'third_party-portainer.md'
  - 'Gogs': 'third_party-gogs.md'
  - 'Gitea': 'third_party-gitea.md'
  - 'Nextcloud': 'third_party-nextcloud.md'
icon:
  logo: 'images/logo.svg'
extra:
  palette:
    primary: 'indigo'
    accent: 'orange'
  social:
    - icon: fontawesome/solid/globe-americas
      link: https://mailcow.email
    - icon: fontawesome/brands/github-alt
      link: https://github.com/mailcow
extra_css: [extra.css]
extra_javascript: [clients.js]