Implementation Blueprint

# Update Server
sudo apt update && sudo apt upgrade -y

# Install Docker and Docker Compose
sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker

mkdir /opt/keila && cd /opt/keila
nano docker-compose.yml

version: '3.8'

services:
  keila:
    image: pentacent/keila:latest
    container_name: keila_app
    restart: always
    ports:
      - "127.0.0.1:8000:4000"
    environment:
      # Database connection
      - DATABASE_URL=ecto://keila:super_secret_db_password@db/keila
      # The public URL where Keila will be hosted
      - HOST=newsletter.mycompany.com
      - PORT=4000
      # Secret key for sessions (generate a random 64 char string)
      - SECRET_KEY_BASE=generate_a_long_random_string_here
      # Allow registration (Set to false after creating your initial admin account)
      - ENABLE_REGISTRATION=true
      
      # (Optional) Pre-configure SMTP here, or do it in the Web UI
      # - SENDER=newsletter@mycompany.com
      # - SMTP_HOST=email-smtp.us-east-1.amazonaws.com
      # - SMTP_USER=ses_username
      # - SMTP_PASS=ses_password
      # - SMTP_PORT=587
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:14-alpine
    container_name: keila_db
    restart: always
    environment:
      - POSTGRES_DB=keila
      - POSTGRES_USER=keila
      - POSTGRES_PASSWORD=super_secret_db_password
    volumes:
      - keila_pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U keila"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  keila_pgdata:

# Run this and copy the output into the SECRET_KEY_BASE in docker-compose.yml
openssl rand -base64 48

cd /opt/keila
docker-compose up -d

sudo apt install nginx -y
sudo nano /etc/nginx/sites-available/keila

server {
    listen 80;
    server_name newsletter.mycompany.com;

    location / {
        proxy_pass http://127.0.0.1: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;
    }
}

sudo ln -s /etc/nginx/sites-available/keila /etc/nginx/sites-enabled/
sudo systemctl reload nginx

// Node.js example
const axios = require('axios');

axios.post('https://newsletter.mycompany.com/api/v1/projects/YOUR_PROJECT_ID/contacts', {
  contact: {
    email: "customer@example.com",
    first_name: "Jane"
  }
}, {
  headers: {
    'Authorization': 'Bearer YOUR_KEILA_API_KEY' // Generated in Keila user settings
  }
});