https://github.com/wodby/opensmtpd
OpenSMTPD docker container image
https://github.com/wodby/opensmtpd
alpine docker mta opensmtpd
Last synced: about 1 year ago
JSON representation
OpenSMTPD docker container image
- Host: GitHub
- URL: https://github.com/wodby/opensmtpd
- Owner: wodby
- Created: 2016-08-11T05:25:03.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2025-02-16T02:28:52.000Z (over 1 year ago)
- Last Synced: 2025-04-15T05:46:54.895Z (about 1 year ago)
- Topics: alpine, docker, mta, opensmtpd
- Language: Shell
- Homepage: https://wodby.com/stacks/opensmtpd
- Size: 94.7 KB
- Stars: 20
- Watchers: 4
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# OpenSMTPD Docker Container Image
[](https://github.com/wodby/opensmtpd/actions)
[](https://hub.docker.com/r/wodby/opensmtpd)
[](https://hub.docker.com/r/wodby/opensmtpd)
## Docker images
❗️For better reliability we release images with stability tags (`wodby/opensmtpd:7-X.X.X`) which correspond to [git tags](https://github.com/wodby/opensmtpd/releases). We strongly recommend using images only with stability tags.
Overview:
- All images based on Alpine Linux
- Base image: [wodby/alpine](https://github.com/wodby/alpine)
- [GitHub actions builds](https://github.com/wodby/opensmtpd/actions)
- [Docker Hub](https://hub.docker.com/r/wodby/opensmtpd)
Supported tags and respective `Dockerfile` links:
- `7`, `7.5`, `latest` [_(Dockerfile)_](https://github.com/wodby/opensmtpd/tree/master/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](https://wodby.com/stacks/opensmtpd).