mirror of
https://github.com/foxcpp/maddy.git
synced 2025-04-05 22:17:39 +03:00
5d6d1a3a53
* use <h3> and <hr> elements to separate configuration directives * use <code> elements to mark constants, fs paths, module names etc. * fix unneeded "\_" escaping * fix list formatting
95 lines
No EOL
2.1 KiB
Markdown
95 lines
No EOL
2.1 KiB
Markdown
# Local queue
|
|
|
|
Queue module buffers messages on disk and retries delivery multiple times to
|
|
another target to ensure reliable delivery.
|
|
|
|
It is also responsible for generation of DSN messages
|
|
in case of delivery failures.
|
|
|
|
## Arguments
|
|
|
|
First argument specifies directory to use for storage.
|
|
Relative paths are relative to the StateDirectory.
|
|
|
|
## Configuration directives
|
|
|
|
```
|
|
target.queue {
|
|
target remote
|
|
location ...
|
|
max_parallelism 16
|
|
max_tries 4
|
|
bounce {
|
|
destination example.org {
|
|
deliver_to &local_mailboxes
|
|
}
|
|
default_destination {
|
|
reject
|
|
}
|
|
}
|
|
|
|
autogenerated_msg_domain example.org
|
|
debug no
|
|
}
|
|
```
|
|
|
|
### target _block_name_
|
|
**Required.** <br>
|
|
Default: not specified
|
|
|
|
Delivery target to use for final delivery.
|
|
|
|
---
|
|
|
|
### location _directory_
|
|
Default: `StateDirectory/configuration_block_name`
|
|
|
|
File system directory to use to store queued messages.
|
|
Relative paths are relative to the StateDirectory.
|
|
|
|
---
|
|
|
|
### max_parallelism _integer_
|
|
Default: `16`
|
|
|
|
Start up to _integer_ goroutines for message processing. Basically, this option
|
|
limits amount of messages tried to be delivered concurrently.
|
|
|
|
---
|
|
|
|
### max_tries _integer_
|
|
Default: `20`
|
|
|
|
Attempt delivery up to _integer_ times. Note that no more attempts will be done
|
|
is permanent error occurred during previous attempt.
|
|
|
|
Delay before the next attempt will be increased exponentially using the
|
|
following formula: 15mins * 1.2 ^ (n - 1) where n is the attempt number.
|
|
This gives you approximately the following sequence of delays:
|
|
18mins, 21mins, 25mins, 31mins, 37mins, 44mins, 53mins, 64mins, ...
|
|
|
|
---
|
|
|
|
### bounce { ... }
|
|
Default: not specified
|
|
|
|
This configuration contains pipeline configuration to be used for generated DSN
|
|
(Delivery Status Notification) messages.
|
|
|
|
If this is block is not present in configuration, DSNs will not be generated.
|
|
Note, however, this is not what you want most of the time.
|
|
|
|
---
|
|
|
|
### autogenerated_msg_domain _domain_
|
|
Default: global directive value
|
|
|
|
Domain to use in sender address for DSNs. Should be specified too if 'bounce'
|
|
block is specified.
|
|
|
|
---
|
|
|
|
### debug _boolean_
|
|
Default: `no`
|
|
|
|
Enable verbose logging. |