zylos-ai 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/
# Access at: https://your.domain.com/document.md
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
# Check Caddy status
pm2 logs caddy
# Validate Caddyfile
~/zylos/bin/caddy validate --config ~/zylos/http/Caddyfile --adapter caddyfile
# Reload after manual Caddyfile edits
pm2 reload caddy
# Access logs
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.