Configuring Hailbox

Hailbox's configuration file location is /etc/hailbox.conf by default, but it can be changed at compile time by editing A sample configuration file with documentation is provided in the "samples" directory of the Mail Hail package.

Copy the sample file to /etc/hailbox.conf and edit it to reflect your mail server and notification needs. Specifying the group that owns the mail spool is optional. If the group is specified, Hailbox will assume that the mail spool is group writable, and mailbox creation and locking will be performed as the owner of the mailbox. If the group is not specified, Hailbox will assume that it has been given root permission, and mailbox creation and locking will be performed as root. In either case, Hailbox writes to a mailbox using the mailbox owner's permissions, so that storage quotas will be enforced during delivery. Delivery notification is optional. The entire notification section may be omitted if this service is not desired.

Configuring Hailbox to deliver local mail is a simple matter of indicating the location of the system mail spool and the name of the group that owns the mail spool. For delivery notification to be performed, more information is required.

The addressing schemes used for E-Mail delivery and notification may be very different. For this reason, Hailbox requires an address filter. A filter reads the user part of an E-Mail address from standard input and writes a notification address for the user to standard output. Some sample address filters are included.

The notification agent is specified as a program to execute. The notification address returned by the address filter is passed to this program as a command-line parameter. The notification message is passed to this program as standard input.

Hailbox may be instructed to include in a notification message certain fields from the header of a delivered E-Mail message. This is indicated by the presence of appropriate tags in the configuration file. Insert tags that name the fields that should appear in notification messages.


hailbox --check

to check the syntax of Hailbox's configuration file and inspect its contents for correctness. Hailbox is now installed on your system.