Replace nginx with Caddy for TLS termination and reverse proxying.
- Replace nginx with Caddy as the web server for both Docker and native
(RPi/Debian) deployments. Caddy handles HTTPS termination, reverse
proxying to all services (API, React app, Controller, Kiwix, Help, Map),
and serves the media/download file browsers.
- Generate a Root CA and signed leaf certificates for HTTPS. The Root CA
uses Name Constraints to restrict signing to local addresses only
(.local, localhost, and RFC 1918 private IP ranges), mitigating MITM
risk if the CA key is compromised.
- Add an HTTP landing page that guides users through one-time CA
certificate installation on iOS, Android, macOS, Windows, Linux, and
Firefox, with auto-redirect when the cert is already trusted.
- Add trailing-slash redirects for /controller, /docs, /media, and
/download so bare paths don't fall through to the React catch-all.
- Add a Root CA download link on the Settings page under Configs.
- Update help.sh diagnostics for IPv6 listener detection and HTTP/2
status codes.
- Remove all nginx config files and the https_proxy Docker container.
- Bump wrolpi-help submodule with certificate documentation.
2026-03-07 12:08:27 -07:00
|
|
|
# Caddy config for WROLPi services (Docker).
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
# No ACME - WROLPi is designed for offline use.
|
|
|
|
|
auto_https disable_redirects
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
:80 {
|
|
|
|
|
handle / {
|
|
|
|
|
root * /var/www
|
|
|
|
|
rewrite * /landing.html
|
|
|
|
|
file_server
|
|
|
|
|
}
|
|
|
|
|
handle /ca.crt {
|
|
|
|
|
root * /opt/media/config/ssl
|
|
|
|
|
header Content-Type "application/x-x509-ca-cert"
|
|
|
|
|
header Content-Disposition "attachment; filename=\"wrolpi-ca.crt\""
|
|
|
|
|
file_server
|
|
|
|
|
}
|
|
|
|
|
handle {
|
|
|
|
|
redir https://{host}:8443{uri} permanent
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
:443 {
|
|
|
|
|
tls /etc/ssl/caddy/cert.crt /etc/ssl/caddy/cert.key
|
|
|
|
|
|
2026-03-07 19:17:38 -07:00
|
|
|
header Access-Control-Allow-Origin "*"
|
|
|
|
|
header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
|
|
|
|
|
header Access-Control-Allow-Headers "Content-Type, Accept"
|
|
|
|
|
|
Replace nginx with Caddy for TLS termination and reverse proxying.
- Replace nginx with Caddy as the web server for both Docker and native
(RPi/Debian) deployments. Caddy handles HTTPS termination, reverse
proxying to all services (API, React app, Controller, Kiwix, Help, Map),
and serves the media/download file browsers.
- Generate a Root CA and signed leaf certificates for HTTPS. The Root CA
uses Name Constraints to restrict signing to local addresses only
(.local, localhost, and RFC 1918 private IP ranges), mitigating MITM
risk if the CA key is compromised.
- Add an HTTP landing page that guides users through one-time CA
certificate installation on iOS, Android, macOS, Windows, Linux, and
Firefox, with auto-redirect when the cert is already trusted.
- Add trailing-slash redirects for /controller, /docs, /media, and
/download so bare paths don't fall through to the React catch-all.
- Add a Root CA download link on the Settings page under Configs.
- Update help.sh diagnostics for IPv6 listener detection and HTTP/2
status codes.
- Remove all nginx config files and the https_proxy Docker container.
- Bump wrolpi-help submodule with certificate documentation.
2026-03-07 12:08:27 -07:00
|
|
|
handle /favicon.ico {
|
|
|
|
|
root * /etc/caddy
|
|
|
|
|
rewrite * /favicon.ico
|
|
|
|
|
file_server
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
handle /apple-touch-icon.png {
|
|
|
|
|
root * /etc/caddy
|
|
|
|
|
rewrite * /icon.png
|
|
|
|
|
file_server
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# WebSocket for React dev server.
|
|
|
|
|
handle /ws {
|
|
|
|
|
reverse_proxy app:3000
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Controller - system management API and UI.
|
|
|
|
|
handle_path /controller/* {
|
|
|
|
|
reverse_proxy controller:8087
|
|
|
|
|
}
|
|
|
|
|
handle /controller {
|
|
|
|
|
redir * /controller/ 301
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Main API.
|
|
|
|
|
handle /api/* {
|
|
|
|
|
reverse_proxy api:8081
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# API docs.
|
|
|
|
|
handle /docs/* {
|
|
|
|
|
reverse_proxy api:8081
|
|
|
|
|
}
|
|
|
|
|
handle /docs {
|
|
|
|
|
redir * /docs/ 301
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-08 09:54:00 -06:00
|
|
|
# Custom MIME types not in Caddy's defaults.
|
|
|
|
|
@yaml path *.yaml *.yml
|
|
|
|
|
header @yaml Content-Type "text/yaml"
|
|
|
|
|
|
|
|
|
|
@epub path *.epub
|
|
|
|
|
header @epub Content-Type "application/epub+zip"
|
|
|
|
|
|
|
|
|
|
@mobi path *.mobi
|
|
|
|
|
header @mobi Content-Type "application/x-mobipocket-ebook"
|
|
|
|
|
|
Replace nginx with Caddy for TLS termination and reverse proxying.
- Replace nginx with Caddy as the web server for both Docker and native
(RPi/Debian) deployments. Caddy handles HTTPS termination, reverse
proxying to all services (API, React app, Controller, Kiwix, Help, Map),
and serves the media/download file browsers.
- Generate a Root CA and signed leaf certificates for HTTPS. The Root CA
uses Name Constraints to restrict signing to local addresses only
(.local, localhost, and RFC 1918 private IP ranges), mitigating MITM
risk if the CA key is compromised.
- Add an HTTP landing page that guides users through one-time CA
certificate installation on iOS, Android, macOS, Windows, Linux, and
Firefox, with auto-redirect when the cert is already trusted.
- Add trailing-slash redirects for /controller, /docs, /media, and
/download so bare paths don't fall through to the React catch-all.
- Add a Root CA download link on the Settings page under Configs.
- Update help.sh diagnostics for IPv6 listener detection and HTTP/2
status codes.
- Remove all nginx config files and the https_proxy Docker container.
- Bump wrolpi-help submodule with certificate documentation.
2026-03-07 12:08:27 -07:00
|
|
|
# Static media files with directory browsing.
|
|
|
|
|
handle_path /media/* {
|
|
|
|
|
root * /opt/media
|
2026-03-08 09:54:00 -06:00
|
|
|
header Content-Disposition "inline"
|
Replace nginx with Caddy for TLS termination and reverse proxying.
- Replace nginx with Caddy as the web server for both Docker and native
(RPi/Debian) deployments. Caddy handles HTTPS termination, reverse
proxying to all services (API, React app, Controller, Kiwix, Help, Map),
and serves the media/download file browsers.
- Generate a Root CA and signed leaf certificates for HTTPS. The Root CA
uses Name Constraints to restrict signing to local addresses only
(.local, localhost, and RFC 1918 private IP ranges), mitigating MITM
risk if the CA key is compromised.
- Add an HTTP landing page that guides users through one-time CA
certificate installation on iOS, Android, macOS, Windows, Linux, and
Firefox, with auto-redirect when the cert is already trusted.
- Add trailing-slash redirects for /controller, /docs, /media, and
/download so bare paths don't fall through to the React catch-all.
- Add a Root CA download link on the Settings page under Configs.
- Update help.sh diagnostics for IPv6 listener detection and HTTP/2
status codes.
- Remove all nginx config files and the https_proxy Docker container.
- Bump wrolpi-help submodule with certificate documentation.
2026-03-07 12:08:27 -07:00
|
|
|
file_server browse
|
|
|
|
|
}
|
|
|
|
|
handle /media {
|
|
|
|
|
redir * /media/ 301
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Downloads with Content-Disposition header.
|
|
|
|
|
handle_path /download/* {
|
|
|
|
|
root * /opt/media
|
|
|
|
|
header Content-Disposition "attachment"
|
|
|
|
|
file_server browse
|
|
|
|
|
}
|
|
|
|
|
handle /download {
|
|
|
|
|
redir * /download/ 301
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# React app with fallback to Controller.
|
|
|
|
|
handle {
|
2026-03-07 19:17:38 -07:00
|
|
|
reverse_proxy app:3000
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
handle_errors 502 503 504 {
|
|
|
|
|
redir * "http://{host}:8087/?fallback=true" 302
|
Replace nginx with Caddy for TLS termination and reverse proxying.
- Replace nginx with Caddy as the web server for both Docker and native
(RPi/Debian) deployments. Caddy handles HTTPS termination, reverse
proxying to all services (API, React app, Controller, Kiwix, Help, Map),
and serves the media/download file browsers.
- Generate a Root CA and signed leaf certificates for HTTPS. The Root CA
uses Name Constraints to restrict signing to local addresses only
(.local, localhost, and RFC 1918 private IP ranges), mitigating MITM
risk if the CA key is compromised.
- Add an HTTP landing page that guides users through one-time CA
certificate installation on iOS, Android, macOS, Windows, Linux, and
Firefox, with auto-redirect when the cert is already trusted.
- Add trailing-slash redirects for /controller, /docs, /media, and
/download so bare paths don't fall through to the React catch-all.
- Add a Root CA download link on the Settings page under Configs.
- Update help.sh diagnostics for IPv6 listener detection and HTTP/2
status codes.
- Remove all nginx config files and the https_proxy Docker container.
- Bump wrolpi-help submodule with certificate documentation.
2026-03-07 12:08:27 -07:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Kiwix HTTPS proxy (replaces zim_https container).
|
|
|
|
|
:8085 {
|
|
|
|
|
tls /etc/ssl/caddy/cert.crt /etc/ssl/caddy/cert.key
|
|
|
|
|
header ?Access-Control-Allow-Origin "*"
|
|
|
|
|
header ?Access-Control-Allow-Methods "GET, OPTIONS"
|
|
|
|
|
reverse_proxy zim:80
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Help HTTPS proxy (replaces help_https container).
|
|
|
|
|
:8086 {
|
|
|
|
|
tls /etc/ssl/caddy/cert.crt /etc/ssl/caddy/cert.key
|
|
|
|
|
header ?Access-Control-Allow-Origin "*"
|
|
|
|
|
header ?Access-Control-Allow-Methods "GET, OPTIONS"
|
|
|
|
|
reverse_proxy help:80
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Map HTTPS proxy (replaces map_https container).
|
|
|
|
|
:8084 {
|
|
|
|
|
tls /etc/ssl/caddy/cert.crt /etc/ssl/caddy/cert.key
|
|
|
|
|
header ?Access-Control-Allow-Origin "*"
|
|
|
|
|
header ?Access-Control-Allow-Methods "GET, OPTIONS"
|
|
|
|
|
reverse_proxy map:80
|
|
|
|
|
}
|