mirror of https://github.com/qbittorrent/qBittorrent.git synced 2026-01-07 16:12:30 -06:00

Table of Contents

Introduction

Usage

Note

Basic auth is available starting from qBittorrent v5.2.0 or WebAPI v2.15.0

Introduction

You can authenticate to the qBittorrent WebAPI/WebUI using basic auth. This allows for shifting the responsibility for authentication to a reverse proxy or identity aware proxy. Basic auth uses the same credentials as the login page.

Usage

Specify your base64-encoded username and password in the Authorization header using a scheme of Basic. For example: Authorization: Basic <BASE64_ENCODED_CREDENTIALS>.

The basic auth header is only used when the client lacks a valid session cookie. Once authenticated, a session cookie is issued and used for subsequent requests. Clients that perform too many failed basic auth attempts are subject to the same time-based banning protections as the login page.