Knowledge base

spool-directory verified

Directory watched for messages

in the configuration this is a linespool-directory: …

Directory the engine watches for message files, reading each one and publishing it as a job.

Values

Values
directory path
applying
restart required
where it can be set
in the config file · with a startup flag · as an environment variable

In detail

Unset by default, so nothing is spooled. Naming a directory turns the node into something any program can hand mail to: write a MIME file, and it is picked up, converted and published. Recipients come from the To, Cc and Bcc headers; the envelope from x-mq-envelope, or failing that Return-Path, Sender or From, in that order. All the x-mq-* control headers work here too, so a file can carry its own sending address, pool and tags. It is the slowest of the five ways to inject mail — disk work per message — and the most compatible with software that has no idea what a message broker is. For a customer migrating from a system that writes files, it is the shortest path to sending through MailerQ without changing their code.

What happens if you get it wrong

Enabled on a directory anything can write to.Whoever can drop a file can send mail from the customer's addresses and choose which one — the control headers are honoured here as well.inference · inference
A file is picked up while still being written.A truncated message is published; spool-delay exists precisely to give the writer time to finish.from the documentation · inference