​

Reverse Proxy & Subdirectory Deployment

​

How it works

• The client build uses relative asset paths by default and detects its own base path at runtime, so it doesn’t need to know about the subdirectory in advance.
• The server understands an optional QUESTARR_BASE_PATH environment variable. When set, it mounts the entire app (API, WebSocket, and static assets) under that prefix, so a reverse proxy can forward requests straight through without rewriting the path.

​

1. Configure Questarr

services:
  app:
    image: ghcr.io/doezer/questarr:latest
    environment:
      - QUESTARR_BASE_PATH=/Questarr
    # ...

docker run -e QUESTARR_BASE_PATH=/Questarr ghcr.io/doezer/questarr:latest

• Serves the app and all /api/* routes under /Questarr/*
• Redirects the unprefixed root (/) to /Questarr/
• Keeps /api/health reachable unprefixed too, so container healthchecks (which talk to the container directly, not through the proxy) keep working unmodified
• Serves the WebSocket (Socket.IO) connection at /Questarr/socket.io/

​

2. Configure your reverse proxy

​

nginx

location = /Questarr {
    return 301 /Questarr/;
}

location /Questarr/ {
    proxy_pass http://app:5000/Questarr/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    # Required for Socket.IO (real-time download/notification updates)
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

​

Traefik (labels)

labels:
  - "traefik.http.routers.questarr.rule=Host(`xxx.domain.com`) && PathPrefix(`/Questarr`)"
  - "traefik.http.services.questarr.loadbalancer.server.port=5000"

​

Caddy

xxx.domain.com {
    redir /Questarr /Questarr/ permanent
    reverse_proxy /Questarr/* app:5000
}

​

3. Verify

​

Notes

• QUESTARR_BASE_PATH accepts letters, numbers, hyphens, underscores, and slashes only (e.g. /Questarr, /games/questarr). Invalid values fail startup with a clear error, the same way other misconfigured environment variables do.
• Changing QUESTARR_BASE_PATH only affects the running server — no rebuild is required, since the pre-built Docker image resolves the base path at runtime rather than baking it into the client bundle at build time.