caddymanager/caddymanager-backend repository overview

⁠CaddyManager Backend

Easily manage your Caddy2 servers with CaddyManager, a modern web-based management platform. The backend is built with Node.js, Express, and MongoDB, providing a secure REST API for multi-server management, configuration editing, user authentication, audit logging, and more.

⁠Features

• Multi-server Caddy2 management via REST API
• Secure JWT-based authentication and role-based access control
• API key management for programmatic access
• Audit logging for all user and system actions
• Real-time server health checks and status
• Integrated Swagger API documentation
• MongoDB for persistent storage

⁠Environment Variables

• PORT (default: 3000)
• MONGODB_URI (MongoDB connection string)
• CORS_ORIGIN (allowed frontend origin)
• LOG_LEVEL (e.g., debug, info)
• DEFAULT_CADDY_ADMIN_USER / DEFAULT_CADDY_ADMIN_PASSWORD
• CADDY_SANDBOX_URL (optional, for config validation)
• PING_INTERVAL, PING_TIMEOUT (health check settings)
• AUDIT_LOG_MAX_SIZE_MB, AUDIT_LOG_RETENTION_DAYS
• JWT_SECRET, JWT_EXPIRATION

⁠Quick Start

docker run -d \
  -e MONGODB_URI=mongodb://user:pass@host:27017/caddymanager?authSource=admin \
  -e CORS_ORIGIN=http://localhost:5173 \
  -e DEFAULT_CADDY_ADMIN_USER=admin \
  -e DEFAULT_CADDY_ADMIN_PASSWORD=changeme \
  -e JWT_SECRET=your_jwt_secret \
  -p 3000:3000 \
  caddymanager/caddymanager-backend:latest