/http

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`: 1. Downloads Caddy binary to `~/zylos/bin/caddy` 2. Prompts for domain, stores in `config.json` 3. Generates Caddyfile 4. Sets port binding capability (`setcap`, one-time sudo) 5. 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.