Install Transmission on FreeNAS 8.0.4 Embedded/Full

Introduction: Install Transmission on FreeNAS 8.0.4 Embedded/Full

Now that you've got your FreeNAS up and running and all that Internet bandwidth idling away. What would you do with it? Of course you want to maximize your machine. Instead of having your FreeNAS and Internet connection bandwidth idle during the night or if it is not sharing files across the network. Why not install a torrent client on your FreeNAS to download all of your favorite torrents. I assume that you already managed to accomplish the following:
1. FreeNAS installed on a USB flash drive.
2. Configured file shares.
3. Have SSH access to your FreeNAS.
4. Your FreeNAS box has Internet access.

Now, please do bear with me, as I'm not a Unix CLI guru. In fact, I still consider myself as a Linux CLI noob. Also, the steps in here is what worked with my system. I tested this on a virtual machine before installing it on a production FreeNAS.

My personal advice:
Install Transmission before using your FreeNAS for production, so when something f*ks up. No data will be lost. What I don't know if this will work with versions prior to 8.0.4.

Note: Execute the commands/edit texts in BOLD face. Text in BOLD are the ones essential in getting transmission installed. If you see commands that are not in BOLD, DO NOT EXECUTE IT. It's for explanatory purposes only.

Teacher Notes

Teachers! Did you use this instructable in your classroom?
Add a Teacher Note to share how you incorporated it into your lesson.

Step 1: Open Your Favorite SSH Client

Open your favorite SSH client, in my case it's PuTTY. Then connect to your FreeNAS box. If you don't have PuTTY, you can download it here,

Then, log-in as root.

Step 2: Create a Downloads Folder

Inside PuTTY create a 'Downloads' folder from one of your shares with the command:
mkdir /mnt/<path to your share>/Downloads

Note: the path that you see in Windows Explorer is not actually the path within the FreeNAS system. All volumes created within the WebGUI of freenas live inside the /mnt folder. If you want to see the volumes inside your FreeNAS:
cd /mnt

Next, change the ownership of the Downloads folder with:
chown -R www:www /mnt/<path to your share>/Downloads

Step 3: Installing Transmission

In order for the install to survive reboots, we have to make the FreeNAS file-system writable:
mount -uw /
Then, install transmission:
pkg_add -r transmission-daemon

And hopefully you would get something like this:
Fetching Done.
Fetching Done.
Fetching Done.
Fetching Done.
Fetching Done.
Fetching Done.
Added group "transmission".
Added user "transmission".

cp /usr/local/etc/rc.d/transmission /conf/base/etc/rc.d

Step 4: Edit /conf/base/etc/rc.conf and /conf/base/etc/rc.d/transmission

First we need to edit /conf/base/etc/rc.conf with the command:
nano /conf/base/etc/rc.conf
Scroll down until you reach the bottom, then append the following lines:

Then press CTRL+O then, ENTER to save it. Then exit with CTRL+X

nano /conf/base/etc/rc.d/transmission

Delete everything, press CTRL+K continuously to delete line after line. Copy-paste the text below(make sure to change the path that is in italics):

  # PROVIDE: transmission-daemon
  # Add the following lines to /etc/rc.conf.local or /etc/rc.conf
  # to enable transmission-daemon:
  # transmission_enable="YES"
  # transmission_args=""
  # transmission_home="/var/transmission"
  # transmission_webhome="/usr/local/share/transmission/web"

  . /etc/rc.subr


  load_rc_config $name

  : ${transmission_enable:="NO"}
  : ${transmission_args:=""}
  : ${transmission_home:="/mnt/<path to your share>/Downloads"}
  : ${transmission_webhome:="/usr/local/share/transmission/web"}


      if [ -n "$TRANSMISSION_HOME" ]; then
          export TRANSMISSION_HOME
      if [ -n "$TRANSMISSION_WEB_HOME" ]; then
          export TRANSMISSION_WEB_HOME

  run_rc_command "$1"

Again, CTRL+O, Enter, CTRL+X.

Step 5: Reboot Your FreeNAS

To reboot:

The reboot is essential to start transmission-daemon and to create the necessary directories under your 'Downloads' folder that transmission needs. If you browse it with Windows Explorer, you would see the folders in the screenshot. I will make it clear, the folders you see there is created by the transmission-daemon after the reboot. Okay? Okay. Next, log-in again to your FreeNAS box via SSH as root. Then kill the transmission-daemon with:
killall transmission-daemon
Then edit the settings.json file with:
nano /mnt/<path to your share>/Downloads/settings.json

Look for the following entries:
"rpc-whitelist-enabled": true,
"download-dir": "//Downloads",
"incomplete-dir": "//Downloads",
"incomplete-dir-enabled": false,

You need to change the values in italicized(above) with the bold ones below
"rpc-whitelist-enabled": false,
"download-dir": "/mnt/<path to your share>/Downloads",
"incomplete-dir": "/mnt/<path to your share>/Downloads/incomplete",
"incomplete-dir-enabled": true,


Then reboot your FreeNAS with:

Step 6: Access Transmission Web GUI

To access the Transmission Web GUI, open your browser then go to
<ip address of your FreeNAS box>:9091

Hopefully you would see a page similar to the screenshot. Transmission accepts both .torrent files and magnet links.

Happy torrenting on your FreeNAS box! :-)

Be the First to Share


    • Trash to Treasure Contest

      Trash to Treasure Contest
    • Raspberry Pi Contest 2020

      Raspberry Pi Contest 2020
    • Wearables Contest

      Wearables Contest

    6 Discussions


    5 years ago on Introduction

    [root@Nas maison] ~# pkg_add -r transmission-daemon

    Error: Unable to get File unavailable (e.g., file not found, no access)

    pkg_add: unable to fetch '' by URL


    5 years ago on Step 3

    Hi there,

    When I try to use this code: "cp /usr/local/etc/rc.d/transmission /conf/base/etc/rc.d"

    I always get: "cp: /conf/base/etc/rc.d: No such file or directory"

    Could anyone help me whit this please?


    6 years ago on Step 3

    hi there. i tried this on 8.3.1 x64 and it worked. however there is newer version of transmission. this method bring me 2.42. is there way how to upgrade to 2.77 for example? thanks in advance.

    btw very good job.


    7 years ago on Step 3

    I tried to delete my comment when I figured it out. it wouldn't let me. :)


    7 years ago on Step 3

    When I try to make the system writable, I get this:
    # mount -uw/ mount:
    illegal option -- /
    usage: mount [-adflpruvw] [-F fstab] [-o options] [-t ufs | external_type] mount [-dfpruvw] special | node
    mount [-dfpruvw] [-o options] [-t ufs | external_type] special node

    any help?


    Reply 7 years ago on Step 3

    So sorry for the late reply. Anyway, there is a space between -uw and the frontslash. Try it again
    mount -uw /