Skip to main content


Transmission is a cross-platform Torrent client.

Initial Setup

Simply run this command

box install transmission

If you are on Ubuntu, you will be offered to use the PPA sources to take updates straight from the transmission team.

The Transmision configuration file will be located in ~/.config/transmission-daemon/settings.json for each user.

Install options

None of these are required for you to define if you want an easy install. If you would like to do something custom, then here are some options for you.

Make sure you know what you're doing!

Please note that it is difficult for us to support these options as they are custom for each install

None of the options are sanity-checked on install so setting something wrong could break your installation.

Again, you do not need to set these if you don't know what you're doing.

There are a couple options you can set before installing transmission through export.

If you'd like to use one of these, run export option=value before running the install command.

The names of the variables correlate to the similar equivalent variables available here on the Transmission configuration docs page

The following is an example of how this would look

export download_dir='torrents/downloads'

For the directory options, the installer will create these automatically (e.g. mkdir -p /home/${user}/${download_dir}, etc.)

Please do note that in the event you have nginx installed, some of these settings will be overridden and the application will pass through the /transmission endpoint on your domain/IP.

  • arg_transmissionsource:
    • Default: Interactive
    • Options: Repo/PPA (Ubuntu only)
    • Setting this will skip the interactive source selection screen.
  • download_dir:
    • Default: transmission/downloads
  • incomplete_dir_enabled
    • Default: false
  • incomplete_dir
    • Default: transmission/incomplete'
  • rpc_whitelist_enabled
    • Default: 0
  • rpc_whitelist
    • Default: '*.*.*.*'
  • rpc_port
    • Default: Next unused port after 9091
  • peer_port
    • Default: Next unused port after 51314
  • rpc_password
    • Default: User's system password

Service management

Transmission has a process for each user, and this is how you can manage it

sudo systemctl start transmission@<user>

Connecting to Transmission Remote

Transmission Remote

Transmission has a desktop remote application available, as well as a couple mobile remote clients for both Android (1) (2) and iOS

To connect to your session, use the following parameters:

  • Host: <your domain/IP>
  • RPC URL: /transmission/rpc (Default usually)
  • Port: 443
  • Username: your normal username
  • Password: your normal password
  • SSL: Yes
  • Validate SSL: ??
    • (Depends if you have LetsEncrypt or an other non-self-signed SSL solution)



You can always also try the general troubleshooting tips written in our guide. They might or might not apply, but asking these questions can often make you understand what is under the hood better and help you find what needs to be fixed. It's always worth a shot!

My speeds to private trackers are slow

Please ensure that your peer ports are open. If you're not sure, change it to a different port and restart Transmission.

It won't start

Please try running transmission-daemon in your terminal with the correct flags to keep it in the foreground, and watch what the output says.