Skip to content

qbitwebui — Runbook

Routine Tasks

Restart

ssh [email protected] "pct exec 118 -- docker restart qbitwebui"

Check status

ssh [email protected] "pct exec 118 -- docker ps --filter name=qbitwebui"

Logs

Log Contents Location Loki query Format
Application Web UI events, qBittorrent API calls Docker (LXC 118) stdout {container="qbitwebui"} Plain text
OAuth2 proxy Authentication events Docker (LXC 119) stdout {container="oauth2-proxy-qbitwebui"} Plain text

Notes: - SSH fallback: ssh [email protected] "pct exec 118 -- docker logs qbitwebui --tail 50"

Troubleshooting

Can't connect to a qBittorrent instance

  1. Check qbitwebui logs: {container="qbitwebui"} |= "error"
  2. Verify the target qBittorrent instance is running on LXC 111
  3. Confirm AuthSubnetWhitelist includes 192.168.1.118/32 in qBittorrent settings
  4. Test connectivity: ssh [email protected] "pct exec 118 -- curl -s http://192.168.1.111:8080"

Login redirect loop

  1. Check oauth2-proxy logs: {container="oauth2-proxy-qbitwebui"} |= "error"
  2. Verify PocketID callback URL includes https://qbit.eva-00.network/oauth2/callback
  3. Check cookie secret is set in Vault: secret/qbitwebui