https://github.com/tozd/docker-nginx-mailer
Nginx Docker image with a simple mailer. Read-only mirror of https://gitlab.com/tozd/docker/nginx-mailer
https://github.com/tozd/docker-nginx-mailer
docker docker-image nginx nullmailer
Last synced: about 1 month ago
JSON representation
Nginx Docker image with a simple mailer. Read-only mirror of https://gitlab.com/tozd/docker/nginx-mailer
- Host: GitHub
- URL: https://github.com/tozd/docker-nginx-mailer
- Owner: tozd
- License: apache-2.0
- Created: 2016-05-01T22:17:39.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2026-04-09T08:05:45.000Z (2 months ago)
- Last Synced: 2026-04-09T10:08:10.699Z (2 months ago)
- Topics: docker, docker-image, nginx, nullmailer
- Language: Dockerfile
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# tozd/nginx-mailer
Available as:
- [`tozd/nginx-mailer`](https://hub.docker.com/r/tozd/nginx-mailer)
- [`registry.gitlab.com/tozd/docker/nginx-mailer`](https://gitlab.com/tozd/docker/nginx-mailer/container_registry)
## Image inheritance
[`tozd/base`](https://gitlab.com/tozd/docker/base) ← [`tozd/dinit`](https://gitlab.com/tozd/docker/dinit) ← [`tozd/nginx`](https://gitlab.com/tozd/docker/nginx) ← `tozd/nginx-mailer`
See also [`tozd/mailer`](https://gitlab.com/tozd/docker/mailer).
## Tags
- `ubuntu-trusty`: nullmailer 1.11
- `ubuntu-xenial`: nullmailer 1.13
- `ubuntu-bionic`: nullmailer 2.1
- `ubuntu-focal`: nullmailer 2.2
- `ubuntu-jammy`: nullmailer 2.2
- `ubuntu-noble`: nullmailer 2.2
- `ubuntu-resolute`: nullmailer 2.2
## Volumes
- `/var/log/nullmailer`: Log files when `LOG_TO_STDOUT` is not set to `1`.
- `/var/spool/nullmailer`: Work files (e.g., queue). Persist this volume to not lose state.
## Variables
- `ADMINADDR`: If set, all e-mails to system users inside a container are send to this address.
- `REMOTES`: E-mail relay server the container should be using to send e-mails.
- `LOG_TO_STDOUT`: If set to `1` output logs to stdout (retrievable using `docker logs`) instead of log volumes.
## Description
Image extending [tozd/nginx](https://gitlab.com/tozd/docker/nginx) image with a simple e-mailing out of the container
using [nullmailer](http://untroubled.org/nullmailer/).
When `LOG_TO_STDOUT` is set to `1`, Docker image logs output to stdout and stderr. All stdout output is JSON.
This image primarily serves as a base image for other images which need to send e-mails out.
It does not really deliver e-mails to wide Internet, but just relays it to the e-mail server
you configure in `REMOTES`. But programs in your extended images do not have to worry
about all that and can just use `sendmail` program locally.
If you need sending e-mails to wide Internet, consider using [`tozd/postfix`](https://gitlab.com/tozd/docker/postfix)
Docker image. You can also then set `REMOTES` to send all e-mail to a `tozd/postfix` container.
## GitHub mirror
There is also a [read-only GitHub mirror available](https://github.com/tozd/docker-nginx-mailer),
if you need to fork the project there.