Skip to content

docker container to use ruby on rails action mailbox with postfix relay

Notifications You must be signed in to change notification settings

Loumaris/action-mailbox-docker-postfix-relay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

ruby on rails action mailbox postfix relay with docker

If you want to use rails action mailbox you need either a smtp-api like sendgrid or an email service like postfix, qmail or exim.

Configure an email server to use it as relay service and pipe all incoming e-mail to a script is not very easy, that's why I created the docker image with a basic postfix service. It works pretty good so far.

how it works

  • configure you rails project's action mailbox to use the relay
  • build this container and run it. (see how to build)
  • you need expose port 25 to the docker container
  • configure your DNS server to point to the docker container (be careful with changing the mx records!)
  • every e-mail which will be send to the domain will be redirected to the deploy user which will call a simple shell script and push it to your action mailbox ingress with the relay task.
  • in this container is a simple rails api application which is only used to call the rake task rails action_mailbox:ingress:postfix

how to build

You need to pass the domain you want to receive e-mails and your action mailbox url and password to the docker build:

git clone [email protected]:Loumaris/action-mailbox-docker-postfix-relay.git
cd action-mailbox-docker-postfix-relay
docker build  -t rails/actionrelay \
              --build-arg TLD=example.org
              --build-arg URL=http://example.org/rails/action_mailbox/relay/inbound_emails
              --build-arg INGRESS_PASSWORD=12345 .

build args

some more details about the build args:

build arg explanation example
TLD your domain you want to send emails, e.g. [email protected] TLD=example.org
URL the action mailbox ingress url URL=http://example.org/rails/action_mailbox/relay/inbound_emails
INGRESS_PASSWORD the password of your action mailbox INGRESS_PASSWORD=12345

support

If you have any questions, feel free to contact me or open an issue.