HUB
Sign inSign up

mouessam/localstack-ses-admin

By mouessam

•Updated 10 months ago

A lightweight admin panel for LocalStack SES Community.

Image
0

546

mouessam/localstack-ses-admin repository overview

⁠LocalStack SES Admin

Tests Coverage License

Admin panel for LocalStack SES Community Edition. Single container providing Fastify API backend with React SPA frontend for managing AWS SES functionality in LocalStack environments.

⁠Quick Start

⁠Docker Run
# Start LocalStack
docker run -d --name localstack -p 4566:4566 -e SERVICES=ses localstack/localstack:latest

# Start SES Admin
docker run -p 8080:8080 \
  -e LOCALSTACK_ENDPOINT=http://host.docker.internal:4566 \
  -e AWS_REGION=us-east-1 \
  mouessam/localstack-ses-admin
⁠Docker Compose
curl -O https://raw.githubusercontent.com/mouessam/localstack-ses-admin/main/docker-compose.yml
docker compose up

Access the admin panel at http://localhost:8080.

⁠Features

  • Verify and delete SES identities (email addresses and domains)
  • Send emails via SES SendEmail API
  • Send raw MIME messages with attachments
  • View and delete messages via /_aws/ses endpoint
  • Clean Architecture with ports/adapters pattern
  • Type-safe Zod contracts between frontend and backend
  • Development hot reload support with Server-Sent Events

⁠Environment Variables

VariableDefaultDescription
LOCALSTACK_ENDPOINThttp://localstack:4566LocalStack SES endpoint URL
AWS_REGIONus-east-1AWS region
AWS_ACCESS_KEY_IDtestAWS access key (for LocalStack)
AWS_SECRET_ACCESS_KEYtestAWS secret key (for LocalStack)
PORT8080Application port

⁠API Endpoints

  • GET /api/health - Health check
  • GET /api/identities - List SES identities
  • POST /api/identities - Create SES identity
  • DELETE /api/identities/:identity - Delete SES identity
  • POST /api/send - Send email
  • POST /api/send-raw - Send raw MIME email
  • GET /api/messages - List received messages
  • DELETE /api/messages - Clear all messages

⁠Docker Tags

  • :latest - Latest stable release
  • :vX.Y.Z - Version-specific releases
  • :X.Y.Z - Version-specific releases (without v prefix)

Multi-architecture support: linux/amd64, linux/arm64

⁠Architecture

This container includes:

  • Backend: Fastify API server with TypeScript
  • Frontend: React SPA served from the same container
  • Build System: Optimized multi-stage Docker build with distroless runtime

⁠Usage Examples

⁠Basic Setup
docker run -d \
  --name ses-admin \
  -p 8080:8080 \
  -e LOCALSTACK_ENDPOINT=http://your-localstack:4566 \
  mouessam/localstack-ses-admin
⁠With Custom AWS Credentials
docker run -d \
  --name ses-admin \
  -p 8080:8080 \
  -e LOCALSTACK_ENDPOINT=http://localstack:4566 \
  -e AWS_REGION=eu-west-1 \
  -e AWS_ACCESS_KEY_ID=your-key \
  -e AWS_SECRET_ACCESS_KEY=your-secret \
  mouessam/localstack-ses-admin
⁠Production Deployment
docker run -d \
  --name ses-admin \
  --restart unless-stopped \
  -p 8080:8080 \
  -e LOCALSTACK_ENDPOINT=https://your-localstack-prod:4566 \
  mouessam/localstack-ses-admin:latest

⁠Limitations

  • SES v1 API only (no v2 support)
  • No SMTP/inbound email functionality
  • Designed for LocalStack Community Edition

⁠License

MIT License. See the source repository⁠ for details.


Note: This image is designed to work with LocalStack. For production AWS SES, use the official AWS SDK and services directly.

Tag summary

Content type

Image

Digest

sha256:51fca5701…

Size

59 MB

Last updated

10 months ago

docker pull mouessam/localstack-ses-admin