Skip to main content

Connecting Torrent Servers

Seed Truck connects directly to supported Transmission and qBittorrent clients. This guide explains the required endpoint, authentication, and reverse-proxy settings.

Supported Clients

  • Transmission 4.1 or later: JSON-RPC 2.0
  • qBittorrent 5 or later: Web UI API v2

Open the Server Editor

  • iPhone or iPad: Open Settings > Servers and choose Add Server.
  • Mac: Open Seed Truck settings, choose Servers, and choose the Add Server button.

Endpoint Rules

Enter a complete address beginning with http:// or https://. Do not place a username or password in the endpoint. The endpoint cannot contain a query or fragment.

HTTP is accepted, but authentication details and traffic are not encrypted. Use HTTPS whenever your server provides it.

Connect Transmission

  1. Choose Transmission under Type.
  2. Enter the full Transmission JSON-RPC endpoint.
  3. Enter the username and password if Transmission requires authentication, or leave both empty.
  4. Choose Test Connection.
  5. Save the server after correcting any reported issue.

A typical endpoint is:

http://server.local:9091/transmission/rpc

The endpoint must include the complete path used by Transmission, normally /transmission/rpc.

Connect qBittorrent

  1. Choose qBittorrent under Type.
  2. Enter the qBittorrent Web UI base URL.
  3. Enter the Web UI username and password, or leave both empty when authentication bypass is configured.
  4. Choose Test Connection.
  5. Save the server after correcting any reported issue.

A typical endpoint is:

http://server.local:8080

Reverse-proxy paths are supported, for example:

https://example.com/qbittorrent

Do not include /api/v2 or another API path in the configured qBittorrent endpoint.

Authentication

  • Enter both Username and Password, or leave both fields empty.
  • Do not put credentials in the endpoint URL.
  • If the server rejects the credentials, verify them in the torrent client's own Web UI and try again.

Custom Headers and Reverse Proxies

Expand Custom Headers (Optional) when a reverse proxy or another authentication layer requires additional HTTP headers. This can support services such as Cloudflare Access, Authelia, or Authentik.

  1. Choose Add Header.
  2. Enter the Header Name and Header Value.
  3. Add any other headers required by the proxy.

Header names must be valid and unique. Treat header values like passwords and do not include them in support requests.

Test and Save

Choose Test Connection after entering the server details. Seed Truck displays the connection result without saving the server. Saving is allowed without a successful test and does not automatically contact the server.

Edit or Delete a Server

Open Settings > Servers and select a saved server to edit its connection or global speed limits. Use the server's Delete action to remove the saved record.

Deleting a saved server removes its connection information from Seed Truck. It does not remove torrents or files from the remote torrent client.