| name | http |
| description | Caddy-based web server providing web console hosting, file sharing, and health check endpoints. Use when configuring HTTP access, setting up file sharing, or troubleshooting web connectivity. |
HTTP Layer (C6)
User-space Caddy web server providing:
- HTTPS with automatic Let's Encrypt certificates
- File sharing via
~/zylos/http/public/
- Health check endpoint
- Component reverse proxy routes (auto-configured by
zylos add)
Architecture
| Component | Path |
|---|
| Binary | ~/zylos/bin/caddy |
| Caddyfile | ~/zylos/http/Caddyfile |
| Public files | ~/zylos/http/public/ |
| Access log | ~/zylos/http/caddy-access.log |
| Domain config | ~/zylos/.zylos/config.json |
Caddy runs as a PM2 service (user-space, no sudo needed for daily operations).
Setup
Caddy is set up automatically during zylos init:
- Downloads Caddy binary to
~/zylos/bin/caddy
- Prompts for domain, stores in
config.json
- Generates Caddyfile
- Sets port binding capability (
setcap, one-time sudo)
- Starts via PM2
To re-run setup: zylos init
Endpoints
| Path | Description |
|---|
/ | File listing or index.html |
/*.md | Markdown documents (served as plain text) |
File Sharing
Place files in ~/zylos/http/public/ to share:
cp document.md ~/zylos/http/public/
Component Routes
Components declare http_routes in SKILL.md frontmatter. Routes are auto-managed via marker blocks in the Caddyfile by zylos add/upgrade/remove.
Troubleshooting
pm2 logs caddy
~/zylos/bin/caddy validate --config ~/zylos/http/Caddyfile --adapter caddyfile
pm2 reload caddy
tail -f ~/zylos/http/caddy-access.log
Port Binding
On Linux, Caddy needs CAP_NET_BIND_SERVICE to bind ports 80/443:
sudo setcap cap_net_bind_service=+ep ~/zylos/bin/caddy
This is set automatically during zylos init. If the binary is replaced (e.g., after an update), re-run the command above.
