caddy-proxy-management

Manage Caddy reverse proxy configurations via the Admin API.

4|1|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/sudocarlos/tailrelay --skill caddy-proxy-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caddy-proxy-management
Source: https://github.com/sudocarlos/tailrelay/tree/main/.agents/skills/caddy
Command: npx skills add https://github.com/sudocarlos/tailrelay --skill caddy-proxy-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the management of Caddy reverse proxies by providing CRUD operations and configuration for routing and TLS, directly interacting with Caddy's Admin API.

Core Features & Use Cases

  • Proxy CRUD: Create, Read, Update, and Delete reverse proxy configurations.
  • TLS Management: Handles automatic TLS certificate provisioning via Caddy.
  • Troubleshooting: Provides tools and insights for diagnosing proxy issues.
  • Use Case: Securely expose a self-hosted web application running on a local port to your Tailscale network by configuring a reverse proxy with automatic HTTPS.

Quick Start

Use the caddy-proxy-management skill to add a new proxy for 'myapp.example.ts.net' targeting 'localhost:8080'.

Frequently Asked Questions about caddy-proxy-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a Caddy reverse proxy dynamically without restarting the server?

Caddy's Admin API enables dynamic reverse proxy configuration via direct HTTP calls to localhost:2019. This method performs atomic configuration updates for routes and TLS without requiring server restarts.

Can I manage automatic TLS certificates for local web apps exposed to a Tailscale network?

Yes, you can manage automatic TLS certificate provisioning for local web apps through Caddy's Admin API. This allows you to securely expose local services to your Tailscale network with automatic HTTPS enabled.

What is the Caddy Admin API used for in reverse proxy management?

The Caddy Admin API is used for performing CRUD operations on reverse proxy configurations. It handles route definition, secure service exposure, and TLS management through atomic updates on localhost:2019.

How do I add a new reverse proxy route targeting a specific local port using Caddy?

You add a new reverse proxy route by applying CRUD operations through the Caddy Admin API. This configures the target address, such as mapping a domain like myapp.example.ts.net to localhost:8080.

Does managing Caddy reverse proxies via the Admin API require external dependencies?

No, managing Caddy reverse proxies via the Admin API requires no external dependencies. It relies solely on direct HTTP calls to the Caddy server's native administration endpoint for configuration updates.

Why is my Caddy reverse proxy configuration not applying updates atomically?

Atomic configuration updates require direct interaction with the Caddy Admin API on localhost:2019. Troubleshooting proxy issues involves verifying these HTTP calls to ensure route definitions and TLS settings are properly applied.