How to use portable mode
- Installing qBittorrent
- Frequently Asked Questions (FAQ)
- qBittorrent options (current and deprecated)
- How to use qBittorrent as a tracker
- How to use portable mode
- Anonymous mode
|Current||qBittorrent ≥ v4.1|
|Previous||qBittorrent v3.2.0 - v4.0.x|
|Obsolete||qBittorrent < v3.2.0|
- Let's Encrypt Certificates + Caddy2 Reverse Proxy
- Let's Encrypt certificates + NGINX reverse proxy - Linux
- Let's Encrypt certificates - Linux
- Self-signed SSL certificates - Linux
- Running qBittorrent without X server (WebUI only)
- Running qBittorrent without X server (WebUI only, systemd service set up, Ubuntu 15.04 or newer)
- OpenVPN and qBittorrent without X server
- Coding style
- How to write a search plugin
- Using VSCode for qBittorrent development
- Setup GDB with Qt pretty printers
- How to debug WebUI code
- Alpine Linux
- CentOS 8.x
- Debian / Ubuntu and derivatives (CMake)
- Debian / Ubuntu and derivatives (autotools/qmake)
- FreeBSD (no GUI)
- Fully static binaries on Linux (glibc or musl)
- Raspberry Pi OS / DietPi
- Raspbian for LeMaker Banana Pro
Clone this wiki locally
Portable mode makes it so that all qBittorrent config files get stored and read from one "portable" directory, to make it easy to migrate and share settings between qBittorrent installations. It also makes it possible to use qBittorrent without installing to- and reading configs from system directories. This feature is most useful for Windows users in general.
NOTE: Only available for version 4.2.1 and above.
--profile=path/to/config/dir --relative-fastresume, where
path/to/config/dir is the folder where you want your portable config to be stored or read from, if the config files already exist inside it.
Alternatively, create a folder literally named
profile in the same directory as the qBittorrent executable, and just run the executable without the
--relative-fastresume flags. The effect is the same as above, inside the
profile directory. However, this is usually not what you want unless you are testing a build of qBittorrent you've compiled yourself in a directory that does not require elevated privileges.
NOTE: there are a bunch of caveats and pitfalls associated with portable mode and the
--relative-fastresume flag in particular. Refer to the man page for more information and things to watch out for about these options. If just you want to use multiple configurations, use
--configuration=config-name-here. TODO: work on the new, complete man page is not yet finished.
- Place the qBittorrent binaries (
qbittorrent.pdb) anywhere you want in your PC. You can extract them from the setup
.exefile using 7-zip or similar (setup files are just fancy self-extracting archives).
- Create a folder called
profilein the same directory as the
qbittorrent.exe. It will initialize the needed configuration files within the
profilefolder and use them during execution.
- Note: You can copy qBittorrent configuration files from any installation, portable or not, to the matching directories inside the
profiledirectory. When started, qBittorrent will use those files if they exist. You can of course move the
profiledirectory around including to different machines, and any
qbittorrent.exestarted beside it will use those configs. Beware that some settings that deal with specific paths may not work out of the box when migrating, because paths may not be exactly the same and may not exist across machines.