mirror of
https://github.com/calibrain/shelfmark.git
synced 2026-02-20 07:46:18 -05:00
0a7785a333
## Summary This PR updates the reverse proxy documentation with comprehensive configuration examples for subpath deployments, addressing several issues discovered when running Shelfmark behind nginx at a subpath like `/shelfmark/`. ## Changes - **Root path setup**: Added complete nginx server block example - **Subpath setup without auth**: Complete nginx configuration with all necessary workarounds - **Subpath setup with Authelia**: Full example including Authelia snippets and Shelfmark proxy auth settings - **Known issues section**: Documents the frontend bugs that require workarounds ## Issues Addressed The current documentation's simple example doesn't work for subpath deployments because: 1. **Socket.IO connects to root**: Frontend connects to `/socket.io/` instead of `/shelfmark/socket.io/` 2. **API calls use root path**: Cover images request `/api/` instead of `/shelfmark/api/` 3. **Logo uses root path**: Requested from `/logo.png` instead of `/shelfmark/logo.png` 4. **Socket.IO backend path**: Always at `/socket.io/` regardless of `URL_BASE` setting ## Testing Tested with: - Nginx reverse proxy - Authelia authentication proxy - `URL_BASE=/shelfmark/` configuration - WebSocket connections working - Cover images loading - Proxy authentication with admin group restrictions Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>