Update documentation

This commit is contained in:
casperklein 2024-08-09 22:13:13 +02:00
parent f2c49f53d9
commit 8285bde12c
3 changed files with 14 additions and 11 deletions

View File

@ -10,14 +10,17 @@ environment:
- GETMAIL_POLL=5 - GETMAIL_POLL=5
``` ```
In your DMS config volume (eg: `docker-data/dms/config/`), create a `getmail-<ID>.cf` file for each remote account that you want to retrieve mail and store into a local DMS account. `<ID>` should be replaced by you, and is just the rest of the filename (eg: `getmail-example.cf`). The contents of each file should be configuration like documented below. In your DMS config volume (eg: `docker-data/dms/config/`), create a new directory `getmail`. Then you can place a `<ID>.cf` file inside for each remote account that you want to retrieve mail and store into a local DMS account. `<ID>` should be replaced by you, and is just the rest of the filename (eg: `imap-example.cf`). The contents of each file should be configuration like documented below.
The directory structure should similar to this: The directory structure should look similar to this:
```txt ```txt
├── docker-data/dms/config ├── docker-data/dms/config
│   ├── dovecot.cf │   ├── dovecot.cf
│   ├── getmail-example.cf │ ├── getmail
│   │ ├── getmailrc_general.cf
│   │ ├── imap-example.cf
│   │ ├── pop3-example.cf
│   ├── postfix-accounts.cf │   ├── postfix-accounts.cf
│   └── postfix-virtual.cf │   └── postfix-virtual.cf
├── docker-compose.yml ├── docker-compose.yml
@ -42,7 +45,7 @@ received = false
delivered_to = false delivered_to = false
``` ```
If you want to use a different base config, mount a file to `/etc/getmailrc_general`. This file will replace the default "Common Options" base config above, that all `getmail-<ID>.cf` files will extend with their configs when used. If you want to use a different base config, place it in `docker-data/dms/config/getmail/getmailrc_general.cf`. This file will replace the default "Common Options" base config above, that all `<ID>.cf` files will extend with their configs when used.
??? example "IMAP Configuration" ??? example "IMAP Configuration"
@ -54,7 +57,7 @@ If you want to use a different base config, mount a file to `/etc/getmailrc_gene
```getmailrc ```getmailrc
[retriever] [retriever]
type = SimpleIMAPRetriever type = SimpleIMAPSSLRetriever
server = imap.gmail.com server = imap.gmail.com
username = alice username = alice
password = notsecure password = notsecure
@ -71,7 +74,7 @@ If you want to use a different base config, mount a file to `/etc/getmailrc_gene
```getmailrc ```getmailrc
[retriever] [retriever]
type = SimplePOP3Retriever type = SimplePOP3SSLRetriever
server = pop3.gmail.com server = pop3.gmail.com
username = alice username = alice
password = notsecure password = notsecure
@ -84,7 +87,7 @@ If you want to use a different base config, mount a file to `/etc/getmailrc_gene
### Polling Interval ### Polling Interval
By default the `getmail` service checks external mail accounts for new mail every 5 minutes. That polling interval is configurable via the `GETMAIL_POLL` ENV variable, with a value in minutes (_default: 5, min: 1, max: 30_): By default the `getmail` service checks external mail accounts for new mail every 5 minutes. That polling interval is configurable via the `GETMAIL_POLL` ENV variable, with a value in minutes (_default: 5, min: 1_):
```yaml ```yaml
environment: environment:

View File

@ -732,7 +732,7 @@ Enable or disable `getmail`.
##### GETMAIL_POLL ##### GETMAIL_POLL
- **5** => `getmail` The number of minutes for the interval. Min: 1; Max: 30; Default: 5. - **5** => `getmail` The number of minutes for the interval. Min: 1; Default: 5.
#### OAUTH2 #### OAUTH2

View File

@ -430,7 +430,7 @@ FETCHMAIL_PARALLEL=0
# - 1 => Enabled # - 1 => Enabled
ENABLE_GETMAIL=0 ENABLE_GETMAIL=0
# The number of minutes for the interval. Min: 1; Max: 30. # The number of minutes for the interval. Min: 1; Default: 5.
GETMAIL_POLL=5 GETMAIL_POLL=5
# ----------------------------------------------- # -----------------------------------------------