Verify it’s running
PUBLIC_URL, sign up, add a debrid key, and paste a magnet — it
should start downloading (or return an instant stream if it’s already cached).
Common issues
Downloads never start / no VPN connection
Downloads never start / no VPN connection
Check gluetun:
docker compose logs -f gluetun. A bad VPN_PRIVATE_KEY,
VPN_ADDRESSES, or provider name is the usual cause. ingest and
qBittorrent share gluetun’s network, so if the VPN is down, downloads stall.Permission denied writing to the cache
Permission denied writing to the cache
The store path (
/mnt/cache/store) and scratch dir must be writable by the
containers. Make sure the mounted disk exists and isn’t read-only.Streams won't play / 'video not found'
Streams won't play / 'video not found'
Almost always a
PUBLIC_URL mismatch — signed URLs are minted against it, so
it must be the exact HTTPS address you serve on. See Exposing publicly.Stremio won't add the addon
Stremio won't add the addon
Stremio requires HTTPS for remote addons. Put the instance behind TLS first
(Exposing publicly), then add the manifest URL.
Hitting plan limits
Hitting plan limits
New accounts are on the Free plan (1 concurrent, 50 GB). Bump your account or
edit the plan limits — see Accounts & plans.
Getting help
- Check CONTRIBUTING.md
- Report security issues via SECURITY.md, not a public issue.