MX server management for iojs.org

Mailgun is used to route email from the iojs.org domain to the aliases described in this repo.

The iojs.org directory contains the aliases.json file which describes the wanted email aliasing. It is structured as a mapping of "from" usernames @iojs.org to "to" actual email addresses.

Since access to the Mailgun API key is required, only members of the @nodejs/build-infra team have the permission to push code to the main branch. That was done in order to minimize the possibility of mismatches between the information in this repo, and the actual email routes that are set up.

The update/ directory contains a node program which will read the aliases mapping file, fetch the list of mail routes from Mailgun and update the routes to make sure they match the required state. The program is run by passing it a domain name as an argument (update/update.js iojs.org).

The Mailgun API key for the given domain is required. It can be found in the admin_logins.md file in the secrets repo (build/infra/), or directly via the Rackspace API. The key should be stored as a file named iojs.org/credentials.json in the form: { "api-key": "key-abc..." } within a code tree.

The programs can be used with --dry-run to verify the current status and what will be changed by an update.

@nodejs.org email addresses are managed by the Linux Foundation. In order to set one up:

• Create an iojs.org alias with associated recipients as described above.
• Send an email to helpdesk@rt.linuxfoundation.org requesting that the wanted nodejs.org address by directed to the new alias. Please CC an OpenJS Foundation contact person and provide context as to why the alias is needed.

The contents of this repository are Copyright (c) Node.js Foundation and licensed under the MIT licence. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE.md file for more details.