Config playground

Pick what rws should do. The file and the command update as you go, and every combination this page can build passes rws --check.

Basics

Port Ignored with HTTPS, which uses 443 and 80. Access log

Reload when the file changeswatch = true; SIGHUP always works.

Automatic HTTPSCertificates from Let's Encrypt, renewed by rws.

Domains Comma or space separated. Point their DNS at this server first. Email for the CA Challenge Use the staging CA firstUntrusted test certificates, generous rate limits.

Reverse proxyLoad balance requests to your app servers.

Backends One per line: host:port or a URL.

Strategy Health check path Leave empty for no health checks.

Only for host Optional, like api.example.com. Path Ending in * matches a prefix.

Rate limit this route

Requests Per seconds

Require a bearer tokenFails closed: no token configured means 503.

Token environment variable

CORSLet browser apps on other origins call this server.

Allowed origins Comma separated.

Global rate limitPer client IP, for every request.

Requests Per seconds

# Nothing to set: with no file at all, rws serves this folder on port 7878.

Save it next to the files you serve, then run:

rws --check && rws

Valid. Every key here is in the config file reference.