Skip to content
marcelorodrigoPublic

About

Sendy.co as Docker

Resources

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

Sendy Docker

Check out Sendy, a self hosted newsletter app that lets you send emails 100x cheaper via Amazon SES.

What is Sendy?

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.

Community Contribution

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.

Features

  • 🏭 Production Ready: Apache/PHP image based on ServerSideUp/PHP images
  • ⚡ High Performance: Fine-tuned for optimal performance with opcache optimized 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: .htaccess support with mod_rewrite enabled
  • 📦 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/uploads and /var/www/html/locale volumes
  • 🌍 Translations: Support for custom Sendy translations
  • 🏗️ Multi-Architecture: amd64 and arm64 native support

Quick Start

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:latest

Docker Compose

A 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:

Image Tags

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.

Environment Variables

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.)

Custom Translations

Sendy includes English (en_US) translations by default. To provide custom translations or add additional languages, see LOCALE.md for detailed instructions.

License

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.

Building Your Own Image

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.

About

Sendy.co as Docker

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages