Reverse proxy
The web container speaks HTTP on port 8080 (see HTTP_PORT). Your reverse proxy accepts requests to your domain with HTTPS and forwards everything to this port: the web app, /api, /mcp, /ical and /auth. Study Manager needs no special path rules.
Important for every proxy:
- Pass on the Host header and
X-Forwarded-For. The app limits requests per visitor. - Upload size: documents can be large. Allow at least 100 MB per request (the app uploads files one by one).
- HTTPS is required: passkeys and Claude's sign-in (OAuth) only work over it.
- If the proxy runs on another machine, set
BIND_ADDRESS=0.0.0.0and protect the port with a firewall so that only the proxy reaches it. Enter the proxy's address inTRUSTED_PROXIESif it is not in a private network.
Caddy
The easiest way if you have no proxy: Caddy gets the certificate itself.
study.example.org {
request_body {
max_size 100MB
}
reverse_proxy 127.0.0.1:8080
}
Nginx Proxy Manager
- Proxy Hosts → Add Proxy Host: domain
study.example.org, schemehttp, forward to<IP of the server>port8080, Websockets Support on. - Tab SSL: request a Let's Encrypt certificate, Force SSL on.
- Tab Advanced:
client_max_body_size 100m;
Traefik
Attach the web container to your Traefik with labels. In a docker-compose.override.yml next to the docker-compose.yml:
services:
web:
ports: !reset []
networks: [default, traefik]
labels:
- traefik.enable=true
- traefik.docker.network=traefik
- traefik.http.routers.study.rule=Host(`study.example.org`)
- traefik.http.routers.study.entrypoints=websecure
- traefik.http.routers.study.tls.certresolver=letsencrypt
- traefik.http.services.study.loadbalancer.server.port=80
networks:
traefik:
external: true
Adjust the names of network, entrypoint and resolver to your Traefik.
Cloudflare Tunnel
A tunnel needs no open port. Point it to the host port:
# config.yml of cloudflared
ingress:
- hostname: study.example.org
service: http://localhost:8080
- service: http_status:404
Note: Cloudflare lets through at most 100 MB per request (on the free plan); larger files cannot be uploaded then. The app sends files one by one. You can additionally put Cloudflare Access in front of /admin and /api/admin; then the admin area is only reachable with a second check. That is optional; the app requires a passkey or authenticator app for admins anyway.
Checking
curl -I https://study.example.org/api/health
must return 200. If the sign-in shows an error, SITE_URL and API_EXTERNAL_URL in the .env usually do not match the address you use in the browser.