marcelorodrigo/sendy repository overview

⁠Sendy Docker

⁠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 /upload volume
• 🌍 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:

⁠Environment Variables

⁠Custom Translations

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

⁠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 [email protected]:marcelorodrigo/sendy.git
export SENDY_LICENSE_KEY=your_license_key_here
docker build -t my-sendy-docker --build-arg .

Make sure to keep your license key safe and never commit it to version control or share it publicly.