Newer
Older
# Nextcloud Mail Admin Documentation
## Installation
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!
## Configuration
Certain advanced or experimental features need to be specifically enabled in your `config.php`:
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
### Automatic account creation
In cases where an external user back-end is used for both your Nextcloud and your mail server you may want to have imap accounts set up automatically for your users.
### Available patterns
Two patterns are available to automatically construct credentials:
* `%USERID%`, e.g. `jan`
* `%EMAIL%`, e.g. `jan@domain.tld`
### Minimal configuration
The following minimal configuration will add such an account as soon as the user logs in. The login password is used for the IMAP and SMTP authentication.
Note: Valid values for SSL are `'none'`, `'ssl'` and `'tls'`.
```
'app.mail.accounts.default' => [
'email' => '%USERID%@domain.tld',
'imapHost' => 'imap.domain.tld',
'imapPort' => 993,
'imapSslMode' => 'ssl',
'smtpHost' => 'smtp.domain.tld',
'smtpPort' => 486,
'smtpSslMode' => 'tls',
],
```
### Advanced configuration
In case you have to tweak IMAP and SMTP username, you can do that too.
```
'app.mail.accounts.default' => [
'email' => '%USERID%@domain.tld',
'imapHost' => 'imap.domain.tld',
'imapPort' => 993,
'imapUser' => '%USERID%@domain.tld',
'imapSslMode' => 'ssl',
'smtpHost' => 'smtp.domain.tld',
'smtpPort' => 486,
'smtpUser' => '%USERID%@domain.tld',
'smtpSslMode' => 'tls',
],
```
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
### Timeouts
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
```php
'app.mail.imap.timeout' => 20
```
#### SMTP timeout
```php
'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)):
```php
'app.mail.transport' => 'php-mail'
```
## Troubleshooting
### Gmail
If you can not access your Gmail account use https://accounts.google.com/DisplayUnlockCaptcha to unlock your account.
### Outlook.com
If you can not access your Outlook.com account try to enable the 'Two-Factor Verification' (https://account.live.com/proofs/Manage) and set up an app password (https://account.live.com/proofs/AppPassword), which you then use for the Nextcloud Mail app.
### Dovecot IMAP
If your Dovecot IMAP server prefixes all folders with `INBOX`, Nextcloud Mail does not work correctly.
Check `/etc/dovecot/dovecot.conf`:
```
namespace inbox {
separator = .
# All folders prefixed
# prefix = INBOX.
prefix =
inbox = yes
type = private
}
```