¶ 
What is Qui?
Qui is a fast, modern web interface for qBittorrent. It supports managing multiple qBittorrent instances from a single, lightweight application with features like cross-seeding, automations, orphan scanning, and backups.
¶ 
1 · Deploy Qui
services:
qui:
image: ghcr.io/autobrr/qui:latest
container_name: qui
user: "568:568"
restart: unless-stopped
ports:
- "7476:7476"
volumes:
- /mnt/tank/configs/qui:/config
- /mnt/tank/media:/media
The media volume mount must match exactly what qBittorrent uses. This is required for orphan scan, hardlink detection, cross-seed reflinks, and automations to work.
¶ 2 · Initial Setup
- Navigate to
http://{IP}:7476 - Set a username and password
- Click Add Instance and enter your qBittorrent connection details
- Enable Local Filesystem Access in the instance settings
¶ 2.1 Add Indexers
- Navigate to Settings → Indexers
- Click 1-click sync to import from Prowlarr or Jackett
Only sync your private trackers! Public trackers aren't useful for cross-seeding and will cause rate limit errors.
¶ 2.2 Add *arr Integration (Optional)
- Navigate to Settings → Integrations
- Add your Sonarr/Radarr instances
This enables IMDb/TMDb ID lookups for better cross-seed match accuracy.
¶ 3 · Configure Cross-Seed
Cross-seeding allows you to seed the same content on multiple trackers automatically.
¶ 3.1 Rules Tab
- Navigate to Cross-Seed → Rules
- Expand Hardlink / Reflink Mode and select your instance
- Set Cross-seed mode to Reflink (for ZFS/Btrfs) or Hardlink
- Set Base directory to a folder on the same filesystem as your downloads (e.g.,
/media/downloads/crossseed) - Set Directory organization to Flat
- Under Categories, select Category affix with Suffix:
.cross - Size Mismatch Tolerance → 0 (or 0.1%)
- Piece Boundary Safety Check → ENABLE it (toggle ON)
Reflink mode is safer if your filesystem supports it (ZFS, Btrfs). It creates copy-on-write clones so any writes don't affect your original files.
¶ 3.2 Auto Tab
¶ RSS Automation
- Toggle Enable RSS automation on
- Set RSS run interval to 60-120 minutes
- Select your qBit instance under Target instances
- Add
radarr.crossandsonarr.crossto Exclude categories - Click Save RSS automation settings
¶ Auto-search on completion
- Toggle your qBit instance On
- Expand the instance settings
- Add
radarr.crossandsonarr.crossto Exclude categories
Excluding
.crosscategories prevents qui from trying to cross-seed torrents that are already cross-seeded.
¶ 4 · Configure Automations
Automations are rule-based actions that automatically manage your torrents based on conditions.
¶ 4.1 Remove Unlinked (Upgraded Torrents)
This removes torrents that are no longer hardlinked to your media library after Radarr/Sonarr upgrades.
- Navigate to Automations and click Add rule
- Set Name to
Remove Unlinked - Add condition:
Hardlink Scopeis notOutside qBittorrent (library/import) - Add condition:
Completed Age>=15days - Set Action to Delete with mode Remove with files (include cross-seeds)
- Leave Include hardlinked copies unchecked
- Click Create and enable the rule
How it works:
- You download a movie → hardlinked to
/media→ scope = "Outside qBittorrent" - Radarr upgrades to better quality → old hardlink deleted → scope becomes "None"
- After 15 days → rule matches → torrent and all cross-seeds deleted
¶ 4.2 Remove Unregistered Torrents
This removes torrents that the tracker no longer recognizes.
- Click Add rule
- Set Name to
Remove Unregistered - Add condition:
Unregisteredistrue - Add condition:
Completed Age>=1day - Set Action to Delete with mode Remove with files (include cross-seeds)
- Leave Include hardlinked copies unchecked
- Click Create and enable the rule
The 1-day grace period prevents deletion during temporary tracker issues.
¶ 4.3 Remove Stalled Downloads (Safe)
This removes downloads that never started — safe for private trackers since you haven't crossed the Hit & Run threshold.
- Click Add rule
- Set Name to
Remove Stalled (No H&R Risk) - Add condition:
Progress<2 - Add condition:
Stateisstalled - Add condition:
Added Age>=1hour - Set Action to Delete with mode Remove with files
- Click Create and enable the rule
¶ 4.4 Tag Stalled Downloads (H&R Risk)
This tags stuck downloads that have Hit & Run risk for manual review.
- Click Add rule
- Set Name to
Tag Stuck (H&R Risk) - Add condition:
Progress>=2 - Add condition:
Progress<100 - Add condition:
Added Age>=2days - Set Action to Tag with tag
stuck-hr-risk - Click Create and enable the rule
Don't auto-delete torrents with H&R risk — you may still owe the tracker. Investigate manually or find an alternative source.
¶ 5 · Configure Orphan Scan
Orphan scan finds files on disk that have no corresponding torrent in qBittorrent.
- Navigate to Automations and expand Orphan Scan
- Toggle your instance On
Orphan scan only checks directories where at least one torrent points. If you delete all torrents from a directory, leftover files there won't be detected.
¶ 6 · Enable Reannounce
Reannounce helps fix torrents that stall right after being added — especially useful with private trackers.
- Navigate to Automations and expand Reannounce
- Toggle your instance On
¶ 
7 · Video
