Caddy
@evrardjp/caddyv2026.07.20.1
01README
Render, validate, and remotely apply Caddy JSON reverse-proxy configuration using a containerized Caddy runtime.
02Release Notes
2026.07.20.1
Added: Initial release of @evrardjp/caddy, with reverse-proxy JSON
rendering, Caddy-native validation, and remote Docker Compose deployment over
SSH.
Added: Upstream transport configuration requires an explicit decision about TLS certificate verification.
Fixed: Remote paths and file content are safely encoded, HTTP-only sites honor disabled TLS, and failed Compose startup no longer removes a running proxy.
Fixed: Container and host restarts now load the durable managed Caddy configuration instead of returning to the bootstrap placeholder.
03Models
@evrardjp/caddyv2026.07.20.1caddy.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| nodeHost? | string | SSH hostname or IP of the node running Caddy; required for apply methods |
| nodeUser | string | SSH user for the node |
| nodePort | number | SSH port |
| nodeIdentityFile | string | SSH private key path |
| workDir | string | Remote directory containing Caddy config and compose file |
| containerImage | string | Caddy container image used for validation/apply |
fn renderReverseProxy(sites: array)
Render Caddy JSON config for HTTPS/HTTP reverse proxy sites
| Argument | Type | Description |
|---|---|---|
| sites | array |
fn validateConfig(configJson: string)
Validate Caddy JSON config before shipping it to a host using Caddy's own parser
| Argument | Type | Description |
|---|---|---|
| configJson | string |
fn applyConfig()
Validate and apply a provided Caddy JSON config on the target host
fn applyReverseProxy()
Render, validate, and apply reverse proxy sites on the target host
Resources
config(infinite)— Rendered Caddy JSON config artifact
validation(infinite)— Caddy JSON validation result
apply(infinite)— Applied Caddy runtime state
04Stats
A
100 / 100
Downloads
1
Archive size
8.4 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels