Skip to content

docs: IMAP deployment guides for all runtime targets #65

@ssilvius

Description

@ssilvius

Goal

Documentation covering IMAP server deployment across all supported platforms.

Guides Needed

@rafters/mail-imap-cloudflare

  • Durable Object setup, wrangler.toml config
  • WebSocket transport, hibernation behavior
  • D1 + R2 wiring for adapters
  • Cost model (hibernated DOs are near-zero)

@rafters/mail-imap-server (covers all process-based runtimes)

Each guide uses the same Node TCP server package with platform-specific deployment:

  • Fly.io: fly.toml, TCP passthrough, auto-scaling by connections, persistent volumes for state
  • Railway: Dockerfile, TCP service, custom domain with port 993
  • AWS Fargate: ECS task definition, ALB TCP listener on 993, ACM for TLS, CloudFormation/CDK
  • Docker/VPS: docker-compose, direct TCP, Let's Encrypt for TLS
  • Deno Deploy: NOT SUPPORTED (no persistent connections). Use Deno in Docker instead.
  • Vercel: NOT SUPPORTED (no persistent connections). Use Fly/Railway alongside Vercel frontend.

Each guide should include:

  • Prerequisites (database, blob storage, auth)
  • Minimal working config
  • TLS/certificate setup for port 993
  • Testing with a real IMAP client (Thunderbird, Apple Mail)
  • Monitoring/health checks
  • Cost expectations

Context

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions