Plausible: Privacy Analytics That Don't Suck

# In docker-compose.yml, add to plausible service:
environment:
  # SMTP Configuration
  MAILER_EMAIL: noreply@yourdomain.com
  SMTP_HOST_ADDR: smtp.mailgun.org
  SMTP_HOST_PORT: 587
  SMTP_USER_NAME: postmaster@yourdomain.com
  SMTP_USER_PASSWORD: ${SMTP_PASSWORD}
  SMTP_RETRIES: 2
  SMTP_TLS: "true"  # Critical for Mailgun and similar

# Or for Gmail (requires App Password now):
environment:
  MAILER_EMAIL: your-email@gmail.com
  SMTP_HOST_ADDR: smtp.gmail.com
  SMTP_HOST_PORT: 587
  SMTP_USER_NAME: your-email@gmail.com
  SMTP_USER_PASSWORD: ${GMAIL_APP_PASSWORD}  # Generate in Google Account settings
  SMTP_TLS: "true"

# Test email sending from within container:
docker exec plausible bash
/app/plausible/bin/plausible exec release_tasks
# Then trigger a password reset to test

# Add ClickHouse configuration with memory limits
services:
  clickhouse:
    image: clickhouse/clickhouse-server:23
    container_name: plausible_clickhouse
    networks:
      - plausible-network
    volumes:
      - ./data/clickhouse:/var/lib/clickhouse
      - ./clickhouse/config.xml:/etc/clickhouse-server/config.d/custom.xml:ro
    ulimits:
      nofile:
        soft: 262144
        hard: 262144

# Create clickhouse/config.xml:
# 
#   1500000000  
#   1000000000
#   1000000000
#   warning
#   
#     warning
#     100M  
#     3   
#   
# 

# For low-traffic sites, you can also disable some ClickHouse features:
# ClickHouse config → disable unnecessary table functions

# Nginx reverse proxy config for Plausible
server {
    listen 443 ssl http2;
    server_name analytics.yourdomain.com;

    # Basic proxy setup
    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Specific CORS handling for event tracking
    location /api/event {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # CORS headers for cross-site tracking
        add_header 'Access-Control-Allow-Origin' '*' always;
        add_header 'Access-Control-Allow-Methods' 'POST, OPTIONS' always;
        add_header 'Access-Control-Allow-Headers' 'Content-Type' always;

        if ($request_method = 'OPTIONS') {
            return 204;
        }
    }
}

# In Plausible docker-compose.yml:
environment:
  BASE_URL: https://analytics.yourdomain.com
  # Important: must match the domain accessing it