Linux Guide

Torrento Connect Linux install guide for quick installs and system services

Install Torrento Connect on a Linux server, seedbox, NAS, or desktop with either the default user-level path or the always-on system service path, then pair it from Torrento on Android.

Current companion release: 1.2.25.

This page covers the Linux install flow only. For the complete documentation hub, go back to Torrento Docs. If you need platform downloads first, use Torrento Connect Downloads.

Open Downloads Back to Docs

Quick Install for Your Current User

Use this path for the normal Linux install. It keeps the runtime under your home directory, installs the command into ~/.local/bin, and tries to start a user service when the machine supports it.

curl -fsSL https://torrento.app/install-connect.sh | sh

The installer is interactive. It starts with the quick user install and only asks for administrator access if you later choose an action that needs to write system files.

Run the install command above on the Linux machine.
Let the installer complete the default user-level setup under your account.
Open the local dashboard at http://localhost:46901 on the machine itself, or http://<server-ip>:46901 from another device on the same LAN.
In Torrento on Android, open Connect and pair the companion.
Add and test your qBittorrent, Transmission, or Deluge clients in the companion before importing them into the app.

Auto-start without a full system install: the quick install can auto-start at sign-in with a user service. On a headless machine, starting before login usually still needs a one-time sudo loginctl enable-linger <user> or the full system install.

System Install for an Always-On Service

Use system mode on a server, NAS, seedbox, or another Linux host that should keep Torrento Connect available at boot for all users.

curl -fsSL https://torrento.app/install-connect.sh | sh -s -- --system

The system path installs commands into /usr/local/bin, stores state in /var/lib/torrento-connect, creates the torrento-connect service user, and runs as a hardened systemd service.

Quick install: user-level setup under your home directory with the simplest default path.
System install: system-owned files plus a dedicated service account for boot-time availability.
Privilege prompt: the installer asks for your password only when it actually needs to modify system directories or configure systemd.

Choose the system path when boot-time availability matters. If the machine is shared, unattended, or should stay online before anyone signs in, the quick user install is not the right long-term mode.

After Install: Pair, Reach the Dashboard, and Update

The Linux companion dashboard is available at http://localhost:46901 on the server itself, or http://<server-ip>:46901 from another device on the same LAN.

After the dashboard opens, pair the companion from Torrento on Android, then add your torrent clients on the companion side. Torrento Connect stores and tests the qBittorrent, Transmission, or Deluge connection details before the Android app imports them.

On SSH-only hosts, the same flow also works without the browser dashboard. Use torrento-connect pair, torrento-connect client add, and torrento-connect client probe directly on the server, then return to the docs hub for the broader platform and product guides.

Firewall access for other LAN devices

If the machine uses firewalld, allow TCP port 46901 from your LAN so another device can open the dashboard.

sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.0.0/24" port port="46901" protocol="tcp" accept' && sudo firewall-cmd --reload

Updates on Linux

Normal user installs can update from the local dashboard with Check Now and Update Now. System installs still use the installer command because replacing a system-owned binary and restarting the service requires administrator access.

curl -fsSL https://torrento.app/install-connect.sh | sh

Pairing and import guide: if you want the full Android pairing flow after install, continue with the Torrento docs hub or the Torrento Connect overview.

Configuration Variables and Uninstall

Override the default installer behavior with environment variables when you need custom paths, a specific service user, or a manual service setup.

TC_INSTALL_MODE - local, system, or auto
TC_INSTALL_DIR - binary location
TC_LIB_DIR - runtime binary directory
TC_DATA_DIR - companion data directory
TC_USER - service user name
TC_SKIP_SERVICE - skip systemd service creation
TC_AGENT_VERSION - optional override when you need the wrapper to report a specific agent version instead of the embedded binary release

Uninstall the quick install

curl -fsSL https://torrento.app/install-connect.sh | sh -s -- --uninstall

Uninstall the system install

curl -fsSL https://torrento.app/install-connect.sh | sh -s -- --uninstall --system

The uninstall flow requests administrator access only when it needs to remove system-owned files and the system service.

Linux Install FAQ

These are the Linux install questions that usually come up before pairing or moving on to headless operations.

Do I need sudo to install Torrento Connect on Linux?

Not for the normal quick install. The Linux installer starts with a user install under your home directory and only asks for administrator access if you choose the system-wide mode or another step that writes system files.

When should I use the system install instead of the quick install?

Use the system install on a server, NAS, seedbox, or another machine that should start Torrento Connect at boot for all users. The quick install is the default path when you want a user-level setup under your own account.

Where do I open the Torrento Connect dashboard after Linux install?

Open http://localhost:46901 on the server itself, or http://<server-ip>:46901 from another device on the same LAN if the firewall allows TCP port 46901.

How do Linux updates work after install?

Normal user installs can update from the local dashboard with Check Now and Update Now. System installs still use the installer command because replacing system-owned files and restarting the service needs administrator access.

Related Docs and Downloads

Continue with the broader companion documentation if you need pairing, headless commands, or another platform.