Skip to main content

Installation

Quick install (Linux x86_64)​

# Download and extract the latest release
wget $(curl -s https://api.github.com/repos/autobrr/qui/releases/latest | grep browser_download_url | grep linux_x86_64 | cut -d\" -f4)

Unpack​

Extract the archive to /usr/local/bin:

tar -C /usr/local/bin -xzf qui*.tar.gz qui

If the command fails with a permission error, run it again with sudo. If you do not have root, or you are on a shared system, extract qui to a directory in your home directory, for example ~/.bin.

Manual download​

Download the latest release for your platform from the releases page. Windows users should follow the Windows guide. For containers, see the Docker guide, and for shared seedboxes, the seedbox installers.

On Linux or macOS, extract the archive:

tar -xzf qui*.tar.gz qui

Run​

If you extracted the archive to /usr/local/bin, the binary is on your PATH:

qui serve

If you extracted to ~/.bin or downloaded the archive by hand, change to that directory first:

chmod +x qui
./qui serve

The web interface is available at http://localhost:7476. To change the port or other settings, see environment variables.

Updating​

On Windows, follow Updating in the Windows guide.

Update from the web UI​

When a new release is available, click Install update in the update banner or in the Update Status row of Settings → Application. The dialog shows the current version, the new version, and a link to the release notes. After you confirm, qui downloads the release, checks its signature, replaces its binary, and restarts. The page reloads when qui is back.

When a new release is available, qui shows Install update for every setup. If automatic installation is unavailable, the dialog explains why. It gives manual update steps and a link to the relevant guide.

Automatic installation requires all of these conditions:

  • qui does not run in a container. To update a container, pull a new image.
  • The running version is a release build, not a local or develop build.
  • qui can write to the directory of its binary. If root owns that directory and qui runs as another user, use sudo qui update.
  • Update checks are on (checkForUpdates), and disableSelfUpdate is not true. See the configuration reference.

While qui checks update support, Install update is disabled. If the support check fails, open the dialog and click Retry. No update starts until the check succeeds and you confirm installation.

If the update fails before qui replaces its binary, the dialog shows the error and qui keeps running on the old version.

Update from the shell​

The qui update command downloads and installs the latest release:

qui update

If you installed qui to /usr/local/bin with sudo, run sudo qui update. If the binary is not on your PATH, run ./qui update from its directory.

Roll back an update​

Both update methods keep the previous binary as qui-v<old version>.bak in the directory of the binary. Each update deletes older backups. The web UI shows the exact rollback command when qui does not answer 60 seconds after an update. The shell update prints it.

To roll back, stop qui, move the backup back, and start qui again. Replace 1.30.0 with the version in the backup file name, and /usr/local/bin with the directory of your binary:

mv "/usr/local/bin/qui-v1.30.0.bak" "/usr/local/bin/qui"

On Windows, follow Roll back an update in the Windows guide.

warning

If you want a full rollback, back up the qui config directory before you update. A new version can migrate the database, which changes its structure. The old version cannot always read a migrated database, and a move of the backup binary does not undo a migration.

First setup​

  1. Open your browser at http://localhost:7476
  2. Create your account
  3. Add your qBittorrent instances
  4. Manage your torrents

Create the account before you expose qui to the Internet, and read Sessions before you put qui behind HTTPS.