OpenSMTPD Docker Container Image

Docker images

❗️For better reliability we release images with stability tags (wodby/opensmtpd:7-X.X.X) which correspond to git tags. We strongly recommend using images only with stability tags.

Overview:

• All images based on Alpine Linux
• Base image: wodby/alpine
• GitHub actions builds
• Docker Hub

Supported tags and respective Dockerfile links:

• 7, 7.5, latest (Dockerfile)

Environment variables

Variable	Default Value	Description
OPENSMTPD_BOUNCE_WARN	1h, 6h, 2d
OPENSMTPD_EXPIRE	4d
OPENSMTPD_MAX_MESSAGE_SIZE	35M
RELAY_HOST
RELAY_PROTO	smtp+tls
RELAY_USER
RELAY_USER_FILE		A file where the user can be found
RELAY_PASSWORD
RELAY_PASSWORD_FILE		A file where the password can be found
RELAY_PORT	587

The XXX_FILE environment variables allow to put the authentication credentials in files rather than environment variables directly. This is typically used to deploy the authentication password using docker secret.

If you store the password in docker secret, e.g.

$ echo 'my secret' | docker secret create smtp_relay_password -

then you can use it setting the RELAY_PASSWORD_FILE environment variable in your container like:

RELAY_PASSWORD_FILE=/run/secrets/smtp_relay_password

Note that you cannot specify both the XXX and XXX_FILE environment variables.

Orchestration actions

Usage:

make COMMAND [params ...]

commands:
    check-ready [host max_try wait_seconds delay_seconds]
 
default params values:
    host localhost
    max_try 1
    wait_seconds 1
    delay_seconds 0

Deployment

Deploy OpenSMTPD to your own server via Wodby.