perteus/caddy-ui repository overview

⁠CPM - Caddy Proxy Manager

🚀 Lightweight web UI for managing Caddy reverse proxy
Wildcard SSL • Docker Auto-Discovery • One-click rule creation

⁠📸 Screenshots

Dashboard — system overview, alerts, quick actions

Proxy Rules — visual editor for reverse proxy configuration

Settings — language, theme, wildcard SSL, Docker discovery, users

Certificates — SSL overview with expiration status

⁠✨ Features

⁠🚀 Quick Start

docker pull perteus/caddy-ui:latest
docker pull perteus/caddy-ui:3.3.1

⁠Docker Compose

version: '3.8'
services:
  caddy:
    image: serfriz/caddy-cloudflare:latest
    container_name: caddy_proxy
    environment:
      - CF_API_TOKEN=${CF_API_TOKEN}
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./caddy-config:/etc/caddy
      - ./caddy-data:/data

  cpm:
    image: perteus/caddy-ui:latest
    container_name: cpm
    ports:
      - "8501:8501"
    environment:
      - CONTAINER_NAME=caddy_proxy
      - DEFAULT_IP=192.168.1.100
    volumes:
      - ./caddy-config:/caddy-config
      - ./caddy-data:/caddy-data
      - /var/run/docker.sock:/var/run/docker.sock

⁠Synology NAS

For Synology, add privileged: true to access the Docker socket.

cpm:
  image: perteus/caddy-ui:latest
  privileged: true
  volumes:
    - /volume1/docker/caddy-config:/caddy-config
    - /volume1/docker/caddy-data:/caddy-data
    - /var/run/docker.sock:/var/run/docker.sock

⁠⚙️ Environment Variables

⁠📝 Version History

⁠v3.2.0 - Docker Auto-Discovery

• ✅ Auto-Discovery — automatic detection of running containers
• ✅ Multi-host support — monitor multiple Docker hosts
• ✅ Smart pairing — match existing proxy rules with containers
• ✅ One-click rule creation — pre-filled from discovered containers
• ✅ Local IP autodetection — detects host IP automatically

⁠v3.1.3 - Security Patch

• ✅ CVE fixes — bump golang.org/x/crypto 0.45.0 → 0.52.0
• ✅ Docker SDK migration — github.com/docker/docker → github.com/moby/moby/client (trvalé řešení)
• ✅ Multi-platform — native amd64 + arm64

⁠🔗 Links

• 📦 Source Code: github.com/TomasZmek/cpm⁠
• 🐛 Report Bugs: GitHub Issues⁠
• 💡 Feature Requests: GitHub Discussions⁠

⁠🙏 Acknowledgments

• 🇰🇷 Korean translation: @redstar-programmer⁠

⁠📄 License

MIT License

CPM - Caddy Proxy Manager
Made with ❤️ for home labs