Mailroom is the RapidPro components which does the heavy lifting of running flow starts, campaigns etc. flows. It interacts directly with the RapidPro database and sends and receives messages with Courier for handling via Redis.

As Mailroom is a Go application, it compiles to a binary and that binary along with the config file is all you need to run it on your server. You can find bundles for each platform in the releases directory. We recommend running Mailroom behind a reverse proxy such as nginx or Elastic Load Balancer that provides HTTPs encryption.

Mailroom uses a tiered configuration system, each option takes precendence over the ones above it:

1. The configuration file
2. Environment variables starting with MAILROOM_
3. Command line parameters

We recommend running Mailroom with no changes to the configuration and no parameters, using only environment variables to configure it. You can use % mailroom --help to see a list of the environment variables and parameters and for more details on each option.

For use with RapidPro, you will want to configure these settings:

• MAILROOM_ADDRESS: the address to bind our web server to (default "localhost")
• MAILROOM_DOMAIN: the domain that mailroom is listening on
• MAILROOM_AUTH_TOKEN: the token clients will need to authenticate web requests (should match setting in RapidPro)
• MAILROOM_ATTACHMENT_DOMAIN: the domain that will be used for relative attachments in flows
• MAILROOM_DB: URL describing how to connect to the RapidPro database (default "postgres:https://temba:temba@localhost/temba?sslmode=disable")
• MAILROOM_REDIS: URL describing how to connect to Redis (default "redis:https://localhost:6379/15")
• MAILROOM_ELASTIC: URL describing how to connect to ElasticSearch (default "https://localhost:9200")
• MAILROOM_SMTP_SERVER: the smtp configuration for sending emails ex: smtp:https://user%40password@server:port/?from=foo%40gmail.com

For writing of message attachments, Mailroom needs access to an S3 bucket, you can configure access to your bucket via:

• MAILROOM_S3_REGION: The region for your S3 bucket (ex: eu-west-1)
• MAILROOM_S3_MEDIA_BUCKET: The name of your S3 bucket (ex: dl-mailroom)
• MAILROOM_S3_MEDIA_PREFIX: The prefix to use for filenames of attachments added to your bucket (ex: attachments)
• MAILROOM_AWS_ACCESS_KEY_ID: The AWS access key id used to authenticate to AWS
• MAILROOM_AWS_SECRET_ACCESS_KEY The AWS secret access key used to authenticate to AWS

While still in beta, Mailroom will move to writing session data to S3 in 6.6, you can configure those buckets using:

• MAILROOM_S3_SESSION_BUCKET: The name of your S3 bucket (ex: rp-sessions)
• MAILROOM_S3_SESSION_PREFIX: The prefix to use for filenames of sessions added to your bucket (ex: ``)

Recommended settings for error and performance monitoring:

• MAILROOM_LIBRATO_USERNAME: The username to use for logging of events to Librato
• MAILROOM_LIBRATO_TOKEN: The token to use for logging of events to Librato
• MAILROOM_SENTRY_DSN: The DSN to use when logging errors to Sentry
• MAILROOM_LOG_LEVEL: the logging level mailroom should use (default "error", use "debug" for more)

Once you've checked out the code, you can build Mailroom with:

go build github.com/nyaruka/mailroom/cmd/mailroom

This will create a new executable in $GOPATH/bin called mailroom.

To run the tests you need to create the test database:

$ createdb mailroom_test
$ createuser -P -E -s mailroom_test (set no password)

To run all of the tests:

go test ./... -p=1