Authentication proxy
Use this setup when a reverse proxy or access gateway already handles sign-in. In header mode, Torah Reading Tracker grants write access when the configured identity header is present.
-
Put
docker-compose.ymlanddocker-compose.override.yml.header-examplein the same directory. Copy the proxy override.cp docker-compose.override.yml.header-example docker-compose.override.yml -
Connect the app and proxy to the same private Docker network. Keep the app's port unpublished and ensure all access goes through the proxy.
-
Configure the proxy to discard any client-supplied identity header, authenticate the user, and then set the trusted header before forwarding the request. The override defaults to
TORAH_AUTH_MODE=header,TORAH_REQUIRE_PROXY_HEADER=true, and the headerX-Torah-Authenticated. Keep those authentication settings when reusing an existing.envfile. SetTORAH_AUTH_HEADERif your proxy uses a different header name. -
Pull the image and start the service.
docker compose pulldocker compose up -d
Confirm that signed-in users can save a reading and that signed-out requests are denied even if they include the identity header. See Configuration for the proxy settings and Docker setup for updates.