This PR adds Docker support to the Unthread Webhook Server, enabling easy containerized deployment with production-ready configuration.

Changes Made

🐳 Added Dockerfile with multi-stage build

• Build stage: Uses Node.js 20 Alpine to install dependencies and compile TypeScript
• Production stage: Uses Node.js 20 Alpine with only production dependencies and compiled code
• Security: Runs as non-root user (nodejs:nodejs) for enhanced security
• Health check: Configured to monitor /health endpoint
• Optimized: Layer caching for faster subsequent builds

📁 Added .dockerignore

• Excludes unnecessary files from build context (node_modules, dist, .git, .env, etc.)
• Reduces build context size and improves build performance
• Follows Docker best practices for Node.js applications

Usage

# Build the image
docker build -t unthread-webhook-server .

# Run with required environment variables
docker run -p 3000:3000 \
  -e REDIS_URL=redis://localhost:6379 \
  -e UNTHREAD_WEBHOOK_SECRET=your_secret_here \
  unthread-webhook-server

Docker Compose Example

version: '3.8'
services:
  webhook-server:
    build: .
    ports:
      - "3000:3000"
    environment:
      - REDIS_URL=redis://redis:6379
      - UNTHREAD_WEBHOOK_SECRET=your_secret_here
    depends_on:
      - redis
  
  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

Verification

• ✅ Docker build completes successfully (~203MB final image)
• ✅ Container starts and runs application correctly
• ✅ Environment validation works as expected
• ✅ Application handles Redis connection gracefully
• ✅ Health check endpoint functional
• ✅ No application code changes required

The containerized application maintains full compatibility with the existing codebase while providing a standardized deployment method across different environments.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.