MAKEHOSTEDDOMAINS(8) Double Precision, Inc. MAKEHOSTEDDOMAINS(8) NAME makehosteddomains - Build a database of hosted domains SYNOPSIS makehosteddomains DESCRIPTION makehosteddomains rebuilds the contents of the /usr/lo- cal/etc/courier/hosteddomains.dat database from the contents of /usr/lo- cal/etc/courier/hosteddomains. This can be either a file or a directory. If it's a directory, the contents of all the files in this directory are sim- ply concatenated. The makehosteddomains script must be run in order for any changes to /usr/local/etc/courier/hosteddomains to take effect. The function of /usr/local/etc/courier/hosteddomains is very similar to the one of /usr/local/etc/courier/locals. Both configuration files specify a list of domains that are considered to be local domains - domains whose mailboxes are stored locally. The difference is that domains listed in /usr/local/etc/courier/locals are removed from addresses before their mailbox is looked up. For example, if the domain "example.com" is listed in /usr/local/etc/courier/locals, then the address <user@example.com> is delivered to a local mailbox named "user". If this domain is listed, instead, in /usr/lo- cal/etc/courier/hosteddomains, then the address <user@example.com> is de- livered to a local mailbox named "user@example.com". Usually you would use /usr/local/etc/courier/locals to specify domains that correspond to your local system accounts, that are looked up in your system's password data- base. The /usr/local/etc/courier/hosteddomains file is usually used when you have database-based virtual domains, that are maintained via an LDAP or a MySQL server. The Courier mail server's LDAP and MySQL authentication modules will use the full E-mail address to query the LDAP or MySQL server for the location of the local mailbox that correspond to the E-mail ad- dress. The Courier mail server's authuserdb authentication module can also use full E-mail addresses. Contents of hosteddomains The file /usr/local/etc/courier/hosteddomains simply contains a list of do- mains, one per line, for example: domain.com example.org Each domain can optionally be followed by a single tab character, in order to specify an alias for a domain, for example: domain.com mail.domain.com<TAB>domain.com example.com<TAB>domain.com First, we list the domain "domain.com" as a hosted domain. Then, we also list the domain "mail.domain.com", which is an alias for domain.com. The Courier mail server will take any address of the form <address@mail.do- main.com>, rewrite it as <address@domain.com>, and attempt to deliver the mail to a local mailbox for that name. The third entry does the same for "example.com"; mail addressed to <address@example.com> is delivered to the local mailbox <address@domain.com>. alias@hosteddomain This is a special local mail delivery rule for hosteddomain-listed domains. This rule allows the Courier mail server accept mail to any address@hosted- domain, where "hosteddomain" is a domain listed in the hosteddomains file, but there is no corresponding account for address@hosteddomain. To provide delivery instructions for any non-existing address in a hosteddomain-listed domain: 1) Create the local address alias@hosteddomain. For example, if the hosted- domains file contains "example.com", create the local account alias@exam- ple.com. This should be a normal account, with its own home directory, userid and groupid. 2) Create $HOME/.courier-default file in this account, containing the de- livery instructions. See the dot-courier(5)[1] manual page for available delivery instructions. NOTE that alias@example.com must be a real account, not a mail alias. If you want to forward alias@example.com to another address, put forwarding instructions in the .courier-default file. However, alias@example.com can be a clone of another account (with the same home directory, userid, and groupid). "WILDCARD DNS" Wildcard DNS is supported for hosteddomains by placing a single period character before the domain name. For example, the hosted domain entry ".domain.com" will cause the Courier mail server to accept mail for "any- thing.domain.com". The Courier mail server will accept mail for <address@any.thing.domain.com> and attempt to deliver it to the local mailbox <address@any.thing.do- main.com>, and if that fails then attempt to deliver the mail to the local mailbox <address@.thing.domain.com>, then finally <address@.domain.com> Note There is a period after the '@' character. If you want all mail for "any.thing.domain.com" to be delivered as though it were sent to "do- main.com", you should define an alias for the domain, for example: domain.com .domain.com<TAB>domain.com SEE ALSO esmtpd(8)[2]. AUTHOR Sam Varshavchik Author NOTES 1. dot-courier(5) http://www.courier-mta.org/dot-courier.html 2. esmtpd(8) http://www.courier-mta.org/esmtpd.html Courier Mail Server 01/22/2022 MAKEHOSTEDDOMAINS(8)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHOR | NOTES
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=makehosteddomains&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>