Transmission is a lightweight and efficient BitTorrent client known for its minimalistic interface and solid performance across multiple platforms. It offers a straightforward user experience while maintaining powerful features under the hood, making it a popular choice for users who want a no-fuss torrenting solution. With its clean WebGUI and support for remote access, Transmission is especially well-suited for NAS devices, allowing you to manage your downloads from any browser on your network.
In this guide, I’ll walk you through the process of installing the Transmission torrent client, complete with its WebGUI, on an IOmega/Lenovo IX4-300d NAS. This setup allows you to harness the power of your NAS for continuous, low-power torrent downloading while managing everything remotely via a simple web interface. Whether you’re looking to automate downloads or just want a convenient way to manage torrents without keeping a PC running, this guide will help you get everything up and running step by step.
Requirements
Before we begin, make sure the following requirements are met:
-
SSH Access (Guide Here):
You must be able to connect to your NAS using SSH. If you haven’t set this up yet, please follow [this SSH access guide]. -
Optware Package Manager Installed (Guide Here):
Transmission will be installed using theipkg
package manager provided by Optware. Make sure it’s installed and working. You can follow [this guide to install Optware]. -
Modified Startup Script (Guide Here):
To ensure Transmission starts automatically after rebooting your NAS, you’ll need a custom startup script located at/mnt/system/opt/init-opt.sh
. Set this up by following [this startup script guide]. -
A Public Share Called “Downloads”:
This guide assumes you have a shared folder namedDownloads
. If you’re using a different share, replace all references to this path accordingly.
-
SSH Access to your NAS. You’ll need to log in remotely to manage files and execute commands. See [this SSH guide] if you haven’t set this up yet.
-
A Custom Startup Script located at
/mnt/system/opt/init-opt.sh
. This ensures that Minecraft starts automatically when the NAS reboots. Follow [this startup script guide] to set it up.
Installing Transmission
Connect via SSH
Start by logging into your NAS using SSH. On most systems, you can use:
Install Transmission
Once connected, run the following command to install the Transmission BitTorrent client:
This will download and install Transmission along with any required dependencies.
Stop the Default Transmission Service
By default, Transmission will start running immediately after installation. However, we need to update its configuration first:
Modify Configuration Settings
Open the settings file using nano
(or your preferred text editor):
Use the down arrow key to scroll until you find the line:
Change the value from 18
to 0
:
This will ensure proper file and folder permissions.
Save the file by pressing:
-
CTRL + O
(to write) -
ENTER
(to confirm) -
CTRL + X
(to exit)
Start Transmission with Proper Access
Depending on who you want to allow access to the Transmission web interface, use one of the following commands:
Allow all IP addresses (including over the internet):
Allow only local network (192.168.x.x):
Allow only a specific IP (your computer):
Replace 192.168.1.100
with your PC’s IP:
Access the Web Interface
In your browser, go to:
You should now see the Transmission WebGUI.
Set the Download Location
Click the wrench icon (⚙️) in the bottom left corner of the WebGUI.
Under the Directories or Download folder setting, change the download path to:
If you want to download into a subfolder or another share, just update the path accordingly.
Auto-Start Transmission on Boot
To make Transmission start automatically when your NAS restarts, you’ll need to add a startup command to your init-opt.sh
script:
-
Open your startup script file:
-
Add the following lines at the bottom:
Adjust the
--allowed
value if you want more restricted access. -
Save and exit (
CTRL+O
,ENTER
,CTRL+X
). -
Restart your NAS. Transmission should now launch automatically and be accessible via the WebGUI within a few minutes.
Errors & Fixes
Port Forwarding (Recommended for Speed)
Open Transmission’s settings via the wrench icon, then go to the Network section.
You’ll see an option to set the incoming port for torrenting.
To maximize download/upload speeds:
-
Choose a port (e.g., 51413)
-
Open your router’s configuration and forward this port to your NAS IP.
Can’t Delete Folders (“Unremovable folders”)
If Transmission creates folders you can’t remove via the UI:
-
SSH into your NAS
-
Navigate to the download location:
-
Then remove the folder manually:
When doing this command file doesn’t seem to be there. It’s empty file.
nano /mnt/pools/A/A0/Downloads/config/transmission/settings.json
Sorry for my bad poor English, but..
I have IX4-300D. Lenovo load Transmission in new release firmware. All work`s fine, but one torrent site don`t work – torrentday.com. But on notebook Transmission I can load torrents with site. How can I see errors, traces, etc on IX4-300D? Have it some logs?
torrentday is a private torrent tracker, so might not work that,
You are a man of genius!!! Thank you and a low bow!! I was able to fix torrent thanks to you! Thanks!! Your articles are wonderful! And with a fan, too!!
Good afternoon. I do everything as stated in the instructions, but after a reboot, everything disappears. What should I do?
You need to modify the startup script of the nas, check https://diyprojects.tech/2013/04/modify-startup-script-on-iomegalenovo-ix4-300d-nas/ and https://diyprojects.tech/2013/11/preserve-custom-servers-after-omegalenovo-ix4-300d-update/ for more info
Dear friend, I am very grateful for your prompt response. But I don’t see the difference between the old instruction and the new one with the changed firmware (the code is the same)
Dear, Steve, my friend today from another city connected to me and tried to help me, made it so that every time I reboot my NAS makes a link to the repository + downloads the latest version of the torrent and installs it, and this is done every time after the system boots automatically. Since we did not manage to do as you have in the article. I am very grateful to my friend, he spent 2 hours trying to understand why my ix4-300d does not save files. I’m happy, but I know it’s not ideal. Would you be able to connect to me and see why I have such a riddle? My mail is in the registration I am ready to send the code from TeamViewer. I understand you if you refuse me. Excuse me.
Hi, the article is very old and my not be up-to-date anymore. i dont use my ix4-300d anymore and switched to unraid. Great to hear you found a way to make it work, even with auto update from git repo. I’m very sorry but i will not be able to help you directly as i cant remember much about this nas.
Okay, thank you!
Finally, I was helped, good man Meyers from the forum https://forums.lenovo.com/t5/Lenovo-Iomega-Networking-Storage/ix4-300d-transmission-suddenly-faulty/m-p/3454281?page=1 he gave me the right file and I now have a torrent restored!! WOW!! I attach a lifebuoy for the same people: https://cloud.mail.ru/public/PxhH/fNJVH1kpY