Skip to main content

Server Settings

The web server is configured at the root level of config.yml.

Settings

host

The IP address the web server binds to.

Value Behavior
"0.0.0.0" Bind on all available network interfaces (default)
"127.0.0.1" Listen on localhost only (not accessible from other machines)
"192.168.1.10" Listen on a specific local IP

port

The TCP port the web server listens on.

Value Notes
80 Standard HTTP port (requires root/admin on most systems)
8080 Default development port (no special privileges needed)
443 Standard HTTPS port (requires root; used with per-site SSL)
1024-49151 User ports (safe from conflicts)

Important: If you plan to use the ACME HTTP-01 challenge, the server must be on port 80.

How HTTP and HTTPS Work Together

When at least one site in sites has ssl configured:

  • HTTPS server runs on the configured host:port (public)
  • HTTP server runs on 127.0.0.1 (internal, auto-assigned port)
  • All traffic enters through the single public port as HTTPS

When no site has SSL:

  • HTTP server runs on the configured host:port (public)
  • No HTTPS

Example

host: "0.0.0.0"
port: 8080