# Caddy

> Caddy automatic HTTPS web server. Use for simple web serving. Use when this capability is needed.

- Skill: `tomevault-io/caddy` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/caddy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/caddy/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/caddy

---


# Caddy

Caddy 2 is a powerful, enterprise-ready web server with **automatic HTTPS** by default. v2.8 (2025) improves **HTTP/3** performance and certificate management.

## When to Use

- **HTTPS Default**: You want zero-config SSL. Caddy obtains and renews certificates automatically.
- **Simplicity**: `Caddyfile` is the most human-readable config format.
- **Go Apps**: Can act as a process manager or library for Go applications.

## Quick Start

```caddyfile
# Caddyfile
example.com {
    reverse_proxy localhost:3000
    encode zstd gzip
    file_server
}
```

## Core Concepts

### Caddyfile

Simple configuration format.
`directive argument { block }`

### JSON Config

The native config format. Caddyfile is adapted to JSON. API allows real-time config updates via REST.

### Modules

Caddy is extensible. Plugins (like `caddy-dns-cloudflare`) are compiled in via `xcaddy`.

## Best Practices (2025)

**Do**:

- **Use Caddyfile**: For 99% of cases, it's enough.
- **Persist /data**: Caddy stores certificates in the `/data` directory. Mount this volume in Docker.
- **Use `caddy fmt`**: Auto-format your config.

**Don't**:

- **Don't sit behind another proxy**: If you hide Caddy behind Cloudflare/Nginx, you break its ACME challenges unless you configure it specifically.

## References

- [Caddy Documentation](https://caddyserver.com/docs/)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/g1joshi) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->