All apps · 0 apps
qbittorrent-filebot
Docker app from pbear's Repository
Overview
Readme
View on GitHub🐳 docker-qBittorrent-filebot
This Docker image combines qBittorrent with the Filebot tool for automated media management. 🚀
📚 Table of Contents
📝 Description
This image is a hardened, security-focused build based on Wolfi (Chainguard). It includes the latest stable release of qBittorrent and FileBot portable.
Why this hardened version?
- Minimal Surface: Uses a minimal footprint to reduce potential security vulnerabilities.
- Enterprise-Grade Patching: Built on Wolfi, ensuring low CVE counts and modern library support.
- Performance: Lightweight execution using
tinifor proper signal handling and zombie process prevention.
It provides an all-in-one, secure solution for downloading and organizing media files. 🎬🎵 For more information about Filebot, please visit https://www.filebot.net
🖥️ Supported Platforms
This image is built for the following architectures:
| Platform | Architecture |
|---|---|
linux/amd64 |
x86_64 — standard servers, NAS (unRAID, Synology x86) |
linux/arm64 |
aarch64 — Raspberry Pi 4/5, ARM NAS, Apple Silicon VMs |
Docker automatically pulls the correct image for your system when using imthai/qbittorrent-filebot:latest.
🔧 Variables
You can customize the behavior of the container using the following variables:
| Variable | Default value | Description |
|---|---|---|
| FILEBOT_LANG | en | Language for Filebot |
| FILEBOT_ACTION | copy | Action to perform (copy, move, symlink, hardlink, keeplink, test) |
| FILEBOT_CONFLICT | auto | Conflict resolution strategy |
| FILEBOT_ARTWORK | yes | Whether to fetch artwork |
| MUSIC_FORMAT | {plex} | Naming format for music files |
| MOVIE_FORMAT | {plex} | Naming format for movie files |
| SERIE_FORMAT | {plex} | Naming format for TV series files |
| ANIME_FORMAT | animes/{n}/{e.pad(3)} - {t} | Naming format for anime files |
| PUID | 99 | User ID for file permissions |
| PGID | 100 | Group ID for file permissions |
| FILES_CHECK_PERM | no | Whether to check file permissions on startup |
| WEBUI | 8080 | Port for the web interface |
⚠️ Important Notes
- Set your PUID and PGID according to your system. The default values (99/100) are for unRAID's nobody/users.
- The {plex} format will organize files into specific folders (Movies, TV Shows, Music). Adjust if needed.
Using {plex.id} instead of {plex} includes the numeric ID in the folder name, which is more machine-friendly. - FILEBOT_ACTION is set to "copy" by default. Be aware of the implications when changing this setting. See below.
- Add your Filebot license file (psm file) to /data/filebot folder and restart the container.
- Default qBittorrent login is "admin". A new password is generated at each startup (check logs) until you set a permanent one.
- To customize the fb.sh script, set custom=1 inside the script to prevent overwriting on restart.
- Setting FILES_CHECK_PERM to "yes" may significantly increase startup time.
- If you change the default ports in the qBittorrent config, update your Docker port mappings accordingly (Not needed if you use a dedicated ip for the container, or host network mode).
Important note about FILEBOT_ACTION: If you choose to set FILEBOT_ACTION to "MOVE" or "HARDLINK", you need to adapt your configuration:
- Use a single general mount point. For example (if you're using unRAID), mount /mnt/user (host) to /onemount (container).
( -v '/mnt/user':'/onemount':'rw' )
2. Adjust the download folder in qBittorrent settings. For example, set it to /onemount/downloads (corresponding to your /mnt/user/downloads under unRAID).
3. Modify the fb.sh script (located in the /data/filebot folder). Change the output to /onemount/media (which corresponds to your /mnt/user/media under unRAID).
📂 Volumes
- /data: Configuration folder
- /downloads: Download folder
- /media: Media folder
🔌 Ports
- 8080/tcp: Web UI
- 6881/tcp: Incoming torrent connections
- 6881/udp: Incoming torrent connections
Port 8080 is mapped by default for the WEBUI, and ports 6881 (tcp & udp) are used for incoming torrent connections. These port mappings are required when using Docker's network bridge mode.
Important notes:
- If you change these ports in the qBittorrent config (via WEBUI for example), remember to update the corresponding port bindings in your Docker run command or compose file.
- If you're using a dedicated IP or network host mode, you can ignore or omit these port bindings.
🚀 Usage Example
docker run -d –name='qbittorrent-filebot'
–net='br0' –ip='10.3.12.21' –ip6='2a01:d33b:f44f:985a:10:2:12:21'
-e TZ="Europe/Paris"
-e 'FILEBOT_ACTION'='copy'
-e 'FILEBOT_LANG'='en'
-e 'MOVIE_FORMAT'='{plex}'
-e 'SERIE_FORMAT'='{plex}'
-e 'PUID'='99'
-e 'PGID'='100'
-v '/mnt/user/media/':'/media':'rw'
-v '/mnt/user/downloads':'/downloads':'rw'
-v '/mnt/user/appdata/qbittorrent-filebot/':'/data':'rw'
'imthai/qbittorrent-filebot'
Note: This example uses a custom network configuration. Adjust according to your needs. 🛠️
Install qbittorrent-filebot on Unraid in a few clicks.
Find qbittorrent-filebot in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.
Categories
Download Statistics
Total Downloads Over Time
Related apps
Explore more like this
Explore allDetails
imthai/qbittorrent-filebotRuntime arguments
- Web UI
http://[IP]:[PORT:8080]- Network
bridge- Shell
sh- Privileged
- false
Template configuration
- Target
- /media
- Value
- /mnt/user/media/
- Target
- /downloads
- Value
- /mnt/user/downloads/
- Target
- /data
- Value
- /mnt/user/appdata/qbittorrent-filebot/
Choices: move | copy | symlink | hardlink | test
- Default
- copy
- Value
- copy
Choices: en | fr | ...
- Value
- en
- Default
- {plex}
- Default
- {plex}
- Default
- animes/{n}/{e.pad(3)} - {t}
- Default
- {plex}
- Default
- 99
- Value
- 99
- Default
- 100
- Value
- 100
- Target
- 8080
- Default
- 8080
- Value
- 8080
- Target
- 6881
- Default
- 6881
- Value
- 6881
- Target
- 6881
- Default
- 6881
- Value
- 6881