Nextcloud Mail Admin Documentation


In your Nextcloud, simply navigate to »Apps«, choose the category »Social & Communication«, find the Mail app and enable it. Then open the Mail app from the app menu. Put in your mail account credentials and off you go!


Certain advanced or experimental features need to be specifically enabled in your config.php:


Depending on your mail host, it may be necessary to increase your IMAP and/or SMTP timeout threshold. Currently IMAP defaults to 20 seconds and SMTP defaults to 2 seconds. They can be changed as follows:

IMAP timeout

'app.mail.imap.timeout' => 20

SMTP timeout

'app.mail.smtp.timeout' => 2

Use php-mail for sending mail

You can use the php-mail function to send mails. This is needed for some webhosters (1&1 (1und1)):

'app.mail.transport' => 'php-mail'

Disable TLS verification for IMAP/SMTP

Turn off TLS verfication for IMAP/SMTP. This happens globally for all accounts and is only needed in edge cases like with email servers that have a self-signed certificate.

'app.mail.verify-tls-peer' => false



If you can not access your Gmail account use to unlock your account.

If you can not access your account try to enable the 'Two-Factor Verification' ( and set up an app password (, which you then use for the Nextcloud Mail app.

Autoconfig for your e-mail domain fails

If autoconfiguration for your domain fails, you can create an autoconfig file and place it as https://autoconfig.yourdomain.tld/mail/config-v1.1.xml For more information please refer to Mozilla's documentation: