Sendy is a self-hosted email newsletter application that lets you send trackable emails via Amazon Simple Email Service (SES). This makes it possible for you to send authenticated bulk emails at an insanely low price without sacrificing deliverability.
This is a community maintained Docker image and is not an official Sendy product or endorsed by Sendy. It is provided as-is for community use.
For official Sendy licensing, support and documentation: please visit Sendy.co.
- 🏭 Production Ready: Apache/PHP image based on ServerSideUp/PHP images
- ⚡ High Performance: Fine-tuned for optimal performance with
opcacheoptimized for production - 🔒 Security: Runs as non-root user
- 💚 Health Checks: Native health check support
- ⚙️ Easy Configuration: Simple and intuitive setup
- ☁️ CloudFlare Support: Native CloudFlare support with real IP addresses from trusted proxies
- 📊 Unified Logging: All logs directed to STDOUT & STDERR for centralized output
- 🔧 Intelligent Init System: Apache + FPM + s6 overlay
- ✅ Validation: Required configuration validation on start-up to prevent mistakes
- 🌐 Web Server Features:
.htaccesssupport withmod_rewriteenabled - 📦 PHP Extensions: All PHP extensions required by Sendy installed and enabled
- 🚀 Latest PHP: PHP 8.5 with opcache enabled
- 💾 Volume Support: Support for
/var/www/html/uploadsand/var/www/html/localevolumes - 🌍 Translations: Support for custom Sendy translations
- 🏗️ Multi-Architecture:
amd64andarm64native support
If you already have a MySQL database for Sendy, you can run the container with the following command.
docker run -d \
-e SENDY_URL=https://newsletters.example.com \
-e MYSQL_HOST=db.example.com \
-e MYSQL_USER=sendy \
-e MYSQL_PASSWORD=Pl3ase_Ch8nge_Me \
-e MYSQL_DATABASE=sendy \
-v sendy_uploads:/var/www/html/uploads \
-p 80:8080 \
-p 443:8443 \
marcelorodrigo/sendy:latestA full example with MySQL using docker-compose is provided below.
services:
sendy:
image: marcelorodrigo/sendy:latest
ports:
- "80:8080"
- "443:8443"
environment:
SENDY_URL: "https://newsletters.example.com"
MYSQL_HOST: "mysql"
MYSQL_USER: "sendy"
MYSQL_PASSWORD: "Pl3ase_Ch8nge_Me"
MYSQL_DATABASE: "sendy"
volumes:
- sendy_uploads:/var/www/html/uploads
# - ./locale:/var/www/html/locale # Optional: provide custom translations (see doc/LOCALE.md)
depends_on:
- mysql
mysql:
image: mysql:8.4
environment:
MYSQL_ROOT_PASSWORD: ThisIsAS7rongR00tPassw0rd
MYSQL_DATABASE: sendy
MYSQL_USER: sendy
MYSQL_PASSWORD: Pl3ase_Ch8nge_Me
volumes:
- mysql_data:/var/lib/mysql
volumes:
sendy_uploads:
mysql_data:| Tag | Description |
|---|---|
latest |
The most recent Sendy release. Rebuilt each time a new Sendy version is published. |
X.Y.Z |
Pinned to that Sendy release (for example 7.1.7). For fully reproducible deployments, pin the image digest (marcelorodrigo/sendy@sha256:...), because a tag can be republished with different image contents. |
Only the current Sendy release is published. The Sendy download endpoint serves the latest version your license is entitled to, so older release tags are not rebuilt automatically. Browse all available tags on Docker Hub.
| Variable | Required | Default | Description |
|---|---|---|---|
SENDY_URL |
Yes | - | URL to your Sendy installation (without the trailing slash) |
MYSQL_HOST |
No | mysql |
MySQL hostname |
MYSQL_USER |
Yes | - | MySQL username |
MYSQL_PASSWORD |
Yes | - | MySQL password |
MYSQL_DATABASE |
No | sendy |
MySQL database name |
MYSQL_PORT |
No | 3306 |
MySQL port |
MYSQL_CHARSET |
No | utf8mb4 |
Database character set |
SENDY_COOKIE_DOMAIN |
No | '' |
Cookie domain (rarely needs changing) |
TRUSTED_PROXY |
No | cloudflare |
Reverse proxy IPs trusted to pass the real client IP: cloudflare, sucuri, local, or off. Set to local when running behind your own reverse proxy (Traefik, nginx, Caddy, etc.) |
Sendy includes English (en_US) translations by default. To provide custom translations or add additional languages, see LOCALE.md for detailed instructions.
The Docker packaging in this repository is released under the MIT License. Sendy itself is commercial software and requires a valid Sendy license. This project is not affiliated with or endorsed by Sendy.
You can build your own image by cloning this repository. A Sendy license is required to use the application.
git clone https://github.com/marcelorodrigo/sendy.git
cd sendy
export SENDY_LICENSE_KEY=your_license_key_here
export SENDY_VERSION=7.1.7 # must match the version your license downloads
docker build \
--build-arg SENDY_VERSION="${SENDY_VERSION}" \
--secret id=SENDY_LICENSE_KEY,env=SENDY_LICENSE_KEY \
-t "my-sendy:${SENDY_VERSION}" .The SENDY_VERSION build argument must match the version your license is entitled to and the
version actually downloaded during the build; the build fails if the downloaded version differs.
The public latest release is informational guidance only — see
sendy.co or the
version endpoint. Make sure to keep your license key
safe and never commit it to version control or share it publicly.
