How to Build a Raspberry Pi TorrentBox

If you already use your Raspberry Pi as a server then you’ll want to add some torrent capabilities to it. Even if you are not using your Raspberry Pi as a server you can turn your Raspberry Pi into a torrent box using a very popular torrent program called Transmission. You may have heard of Transmission before, it comes pre-installed on many popular Debian based Linux distro’s.

Transmission is usually a standalone program you can use to manage your torrents but today I will be showing your how to install Transmission on your Raspberry Pi and run and manage your torrents from your browser. This is beneficial because you can download torrents from anywhere in your house and connect your Raspberry Pi to a Network Attached Storage and store your files there. If you have a VPN at home you can even connect to your network and tell your Raspberry Pi TorrentBox what to download.

I currently have my Raspberry Pi running a network wide adblocker, Kodi, and a Raspberry Pi VPN and found that it can handle running a torrent client like Transmission with ease. Transmission really doesn’t take up to much process power and the Raspberry Pi runs the web GUI with ease.


To install a torrent client onto our Raspberry Pi and turn our Raspberry Pi into a TorrentBox


You will need the following:


I will assume you are running Raspbian on your Raspberry Pi. You can also follow this tutorial for any Debian based Linux distro. I have Rasbian Jessie Lite installed on my Raspberry Pi and will be connecting to my Pi over SSH to install Transmission.

Connect to your Raspberry Pi over SSH or open a new terminal window and run the following commands to bring your Raspberry Pi up to date:

Now lets install Transmission with the following command:

It should take a few minutes to download and install Transmission on the Pi. Once Transmission is installed we will need to stop it so that we can make some changes in the settings so that we can actually access it. Let’s stop Transmission with the following command:

Now we will use the text editor Nano to edit the settings. Run the following command to enter the settings for Transmission:

Head down to the line that says “rpc-whitelist“, we will need to add our local network to this. The default will just have which will only allow access to the Raspberry Pi itself. My router is setup to give out IP Addresses on my network in the 192.168.1.* range. I will add that range of IP Addresses after the as you can see in the photos below.

Before any changes.
After changes made

Once you change the white-list settings you will also want to change the “rpc-authentication-required” from true to false. This will disable the login that is required when trying to access the GUI. Another optional change that you can make is change the web port that is used to access the Transmission GUI. The default port is 9091. The line you would change this is the “rpc-port“.

Once you make your changes you can save them with CTRL+X and then Y.

Now you can start up Transmission using the following command:

You can now access the transmission GUI by opening up your web browser to manage your TorrentBox and typing in your Raspberry Pi’s IP Address and the port you used in the settings. My local Raspberry Pi IP Address is and I used the default port for Transmission.

From here you will have your Transmission GUI where you can add torrents and manage all your downloads. You will be able to access your torrents from anywhere in your house as long as you are connected to your network. The advantage of using your Raspberry Pi as a TorrentBox like this is you don’t have to have a dedicated computer to seed your torrents and you can download new torrents anytime you like.

That basically covers the basics of installing Transmission and turning your Raspberry Pi into a TorrentBox.



  • Andrew Black

    July 27, 2017

    its nice tutorial but i have i problem
    i plugged my usb drive to my pi
    and when i add a torrent it said permission denied “/media/torrentpi/SYSTEMDRIVE/torrent-pi/completed/torrentnamehere”
    SYSTEMDRIVE is the usb drive name
    torrentpi is the pi name
    torrnet-pi is the folder on my usb drive
    how to dismiss and contunie the downloading?

  • Kristof

    August 17, 2017

    is your drive formatted as fat32 or ntfs?

    Or is it possible that you have insufficient priviliges on your drive? try a sudo chmod 755 %path% and see if that works.

  • Piet

    January 20, 2018

    Normally a USB would mount as “/mount/YOUR_USERNAME/USB-LABEL/” . what happened in your case ?


Leave a Reply