KonCad

Web UI for managing an existing dockerized Caddy instance. Parses the Caddyfile into structured sections — global options and per-site blocks — so you don't have to edit raw config files.

Features

  • Structured editor — separate panels for global options and each site block
  • Admin API check — blocks editing if Caddy's admin API is unreachable on load
  • Admin API toggle — one checkbox adds/removes admin :2019 from global options
  • Upstream reachability check — warns before deploy if any reverse_proxy target is unreachable, with option to deploy anyway
  • Atomic deploy — posts config to Caddy's /load endpoint; bad configs are rejected without disrupting the running instance

Requirements

  • Docker + Docker Compose
  • An existing Caddy container with the admin API enabled (admin :2019 in global options)
  • Both containers on the same Docker network

Setup

1. Create a docker-compose.yml

services:
  koncad:
    image: git.d4nn13.de/d4nn13/koncad:latest
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - koncad_data:/data
      - /opt/caddy:/caddy:ro
    environment:
      CADDY_ADMIN_URL: http://caddy:2019
      CADDYFILE_IMPORT: /caddy/Caddyfile
    networks:
      - caddy-network

volumes:
  koncad_data:

networks:
  caddy-network:
    external: true

Adjust to match your environment:

Setting Description
CADDY_ADMIN_URL URL of Caddy's admin API — use the container name as hostname
CADDYFILE_IMPORT Path to your existing Caddyfile (read-only, used once on first boot)
- /opt/caddy:/caddy:ro Adjust to wherever your Caddy config directory lives
caddy-network Replace with your existing Caddy Docker network name

2. Start

docker compose up -d

Updating

docker compose pull && docker compose up -d

KonCad is available at http://<host>:8080.

On first load it imports your existing Caddyfile (read-only). After the first deploy, KonCad manages its own copy.

Usage

Action Description
Global Options panel Edit top-level Caddy options (email, logging, etc.)
Enable Admin API checkbox Adds/removes admin :2019 from global options
+ Add Site Creates a new site block
Remove (per site) Deletes that site block
Deploy Validates and applies config via Caddy's /load API; shows errors inline if rejected

If any reverse_proxy upstream is unreachable at deploy time, a warning modal lists them — you can cancel or deploy anyway.

S
Description
Web UI for managing dockerized Caddy
Readme
216 KiB
0 Stars 1 Watchers 0 Forks
KonCad v0.1.1
Latest
2026-05-03 19:16:40 +02:00
Languages
PHP 99.6%
Dockerfile 0.4%