Unofficial

Questions and answers

67 answers about Rtorrent 16 on a QNAP NAS: installing, folders, speed, ports and VPN, seeding, the media library, add-ons and the phone app. The answers use the panel's own names for its pages, switches and buttons.

Installation and sign-in7

Where do I get Rtorrent 16, and does it cost anything?

Symptoms

  • You look for Rtorrent 16 in App Center and do not know where to install it from.
  • You want to know whether the package costs anything or needs a licence key.

Cause

Rtorrent 16 is freeware, with no licence key and no paid version. You may use it on any number of QNAP NAS units that you own or administer, at home or in a business. You install the package in App Center, from the QNAP Utilities repository or from a downloaded file. It runs on QTS 6.0 or QuTS hero 6.0 or later, with an Intel, AMD or 64-bit ARM processor.

Resolution

  1. In App Center, open "Settings" (the gear icon), then "App Repository" and "Add".
  2. Enter the name QNAP Utilities and the URL https://www.qnaputilities.com/repo.xml, then press "Add".
  3. Open QNAP Utilities in App Center's left rail and install Rtorrent 16. App Center installs the package on the volume you choose, starts it and later offers its updates.
  4. Without the repository: download the file for your processor from https://pub.qnaputilities.com/rtorrent16/download/ (the file ending in _x86_64.qpkg for Intel and AMD, or in _arm_64.qpkg for 64-bit ARM). In App Center, choose "Install Manually" and pick that file. App Center offers no updates for a package installed this way, so you install a newer file the same way.

Tips

  • The Support page in the menu shows how to support the project once or every month through Stripe.
  • One day after the install, the panel shows a Rtorrent 16 is freeware window. Later puts it off for 24 hours, and I already do turns the reminder off on this NAS for good. The panel does not check whether you support the project.
  • Do not install the package from the console with sh. App Center then counts it as unsigned and turns it off.

Rtorrent 16 guide: Installation

Does it run on ARM?

Yes, on a NAS with a 64-bit ARM processor: install the file that ends in arm_64. A NAS with a 32-bit ARM processor does not get QTS 6, so there is no package for it. Over SSH, uname -m shows the processor type.

Is ruTorrent still there?

Yes, with its plugins. The Launcher opens it with one click. Ports and NAT, the certificate, the media library, notifications, performance, backups and the guides are in the Control Center.

What are the panel's login and password after the install?

Symptoms

  • After the install, the Rtorrent 16 panel asks for a login and a password.
  • Your NAS login and password do not work.

Cause

The panel has its own accounts, separate from the NAS's accounts. Every new install starts with the login rtorrent and the password admin. This password is the same on every install, so change it right after your first sign-in. Until you do, the Launcher shows the login in its First start: login card, and the Security page shows the warning Default password still in use.

Resolution

  1. Open http://<nas-address>:6019/ and sign in with the login rtorrent and the password admin.
  2. Open Security. In the Login credentials card, the Username field shows the account you are signed in with. Leave it as it is.
  3. Type the new password in New password and Repeat password. It needs at least 6 characters.
  4. Press Update login. The new password works at once. Other browsers signed in with this account are signed out, and this one stays signed in.

Tips

  • Another name in the Username field creates a new account. The default password warning then goes away, but the rtorrent account still takes the password admin. To use another name, sign in with the new account and remove the rtorrent account with the bin in the Accounts card.
  • A package update keeps the accounts and their passwords. After you remove the package, a new install starts again with the login rtorrent and the password admin.

Rtorrent 16 guide: Login and password

I forgot the panel's password

Symptoms

  • The sign-in page does not take your password, and you do not remember which one you set.
  • After a few failed tries from outside your home network, every page of the panel answers with error 403.

Cause

The panel has its own accounts, separate from the NAS's accounts, and no password reminder. You set a new password with one command over SSH. The panel blocks an address outside the local network for 24 hours after 5 different wrong passwords within five minutes. The block holds even when the right password follows. Local network addresses are exempt.

Resolution

  1. Sign in to the NAS over SSH as admin.
  2. List the panel's accounts: /etc/init.d/rtorrent16.sh user-list
  3. Set a new password for your account, for example the account rtorrent: /etc/init.d/rtorrent16.sh passwd rtorrent NewPassword. The password works at once, without a restart of the package.
  4. If your address is blocked, lift the block: /etc/init.d/rtorrent16.sh unban all. In the panel, open Security and press Lift the ban in the Wrong passwords card.

Tips

  • The Rtorrent 16 phone app stays paired and needs no new password. Enter it in the apps that sign in to the panel with a login and password, such as Sonarr and Radarr. The block counts only different passwords, so an old password sent again and again is one try.
  • While you know the password, change it in the panel: Security → the Login credentials card → Update login.

Rtorrent 16 guide: Login and password

Can another person or an app have its own panel account?

Symptoms

  • You want someone at home to sign in to the panel with a login of their own, not yours.
  • Sonarr, Radarr or another app should connect to Rtorrent 16 without your password.

Cause

The panel can have many accounts, each with its own password. All accounts have the same rights. There are no read-only accounts. The same accounts sign in to the panel, to ruTorrent and to /RPC2, the address Sonarr and Radarr connect to. When an app has an account of its own, a change of your password does not cut it off, and you can remove its account on its own.

Resolution

  1. Open Security and find the Accounts card.
  2. In New account, type a name, for example anna or sonarr: 2 to 32 characters, lower-case letters, digits, _ or -, starting with a letter or a digit. In Password, type at least 6 characters.
  3. Press Create account. The new account can sign in at once.
  4. For an app, open Settings → Media servers. The Connect another app card gives the host, the port and the path RPC2. It shows your own account as the user, so type the new account's name and password in the app instead.

Tips

  • Apps on other devices reach /RPC2 only while Let apps on other machines use /RPC2 (with login) is on under Settings → Web access. It is on by default.
  • The bin beside an account removes it after you confirm. The account is then signed out everywhere, and phones paired with it lose their pairing. You cannot remove the account you are signed in with.
  • Creating an account hides the default password warning, even while the rtorrent account still has the password admin. Change that password before you add accounts.

Rtorrent 16 guide: Login and password

What does an update keep, and what does removing the package delete?

Symptoms

  • You want to update Rtorrent 16 and do not know whether you will lose your settings or the torrent list.
  • You want to remove the package or install it again, and keep the downloaded files and the torrent list.

Cause

An update keeps the settings, the accounts and passwords, the certificate, the categories, the notifications, the tracker accounts, the RSS feeds and rules, and the torrent list. Removing the package deletes the whole package folder, and with it the settings, accounts, passwords and the certificate. It also deletes the torrent list, because rtorrent keeps it with the package by default. The base folder on the share stays: the downloaded and completed files, the watch folder, the media library, and the backups/ folder with the daily copies of the torrent list and the configuration.

Resolution

  1. Install an update over the installed package, without removing it first. A package from the repository updates in App Center; one you installed by hand takes the newer file through "Install Manually".
  2. Before you remove the package, open Settings → Files & storage. If Where rtorrent keeps its session is set to With the package, choose In the base folder.
  3. Press Review & save, then Save 1 change, and confirm with Move. The torrent list goes to the session/ folder in the base folder, which a removal leaves alone.
  4. After installing again, choose In the base folder there once more. The panel merges the saved list into the current one.

Tips

  • Every day the package saves a copy of the torrent list and of the configuration in the backups/ folder of the base folder, the last 14 by default. Back up now in the Backups card on Diagnostics takes a copy of this moment. If the base folder is in the same place after you install again, restore the torrent list and the configuration from these copies in the same card.
  • The configuration copy holds the panel password and the tracker logins. Treat it like a password.

Rtorrent 16 guide: Installation

Torrents and folders7

How do I change the download folder or move everything to another volume?

Symptoms

  • The volume with your downloads is filling up, and you want to download to another disk.
  • After you changed the download directory, the older torrents are still in the old place.

Cause

The downloads/, complete/, watch/ and medialibrary/ folders are in the base folder while their fields in the settings are empty. Moving the base folder changes where new downloads, completed copies, the watch folder and the library go, but the torrents you already have stay in their folders and seed from there. You move torrents together with their data separately, with Move torrents.

Resolution

  1. Open Settings → Files & storage. At the top, Base folder shows the current folder, its volume and its free space. Press Move to another volume. The button stays disabled while the page has unsaved changes.
  2. Open the folder that is to become the new base folder and press Use this folder. It can be the shared folder itself, such as one you created for Rtorrent 16.
  3. Read the summary. From: and To: give the old and the new place, Stays: lists what does not move, and Free space: shows the free space on the new volume. Press Move. rtorrent and the panel stop during the move and start again afterwards.
  4. To move the torrents you already have as well, press More (…) on Quick access, then Move torrents. Select the torrents, press Move to, open the destination folder and press Move here. Read the plan and press Move torrents: ….

Tips

  • With Move torrents, each torrent stops only while it moves. A copy to another volume is checked before the originals are deleted.
  • The Download directory field alone, in Settings → Files & storage, changes the folder for new torrents only. The data you already downloaded stay where they are.
  • If your media server, Radarr or Sonarr uses the old library folder, update the path there.

Rtorrent 16 guide: Control Center · Rtorrent 16 guide: Torrents

How do I make each category download into its own folder?

Symptoms

  • You want films, series and music to land in separate folders.
  • You do not know where a torrent of a given category ends up.

Cause

Rtorrent 16 does this by default. Each category has its own folder in the download directory: a torrent with the category movie downloads into downloads/movie/, and there into a folder named like the torrent. The completed copy goes to that category's folder in complete/. The panel proposes the category from the torrent's name, and you can change it when you add the torrent and later.

Resolution

  1. On the Add torrent page, each torrent in the queue has a row of category chips with the panel's guess picked. If the guess is wrong, click the right category. Leave Directory (optional) empty, and the torrent goes to the category's folder.
  2. To add a category of your own, press the + chip after the categories, type a name in New label and press Add. The panel makes a folder for it, for example downloads/ksiazki_dla_dzieci/ for the name "Książki dla dzieci".
  3. To change the category of a torrent you already added, open Quick access. Press the label on the torrent's row, pick a category, read where the data are and where they go, and press Move. The data and the completed copy move to the new category's folders.
  4. Without opening the panel: make a subfolder named after the category in the watch folder, for example watch/tv/. A .torrent file copied into it gets that category and downloads into downloads/tv/. A new subfolder starts working within five minutes, or within 15 seconds while Quick access or the Dashboard is open. A file copied into it before that is added too.

Tips

  • No setting gives a category a folder outside the download directory. To send a single torrent elsewhere, use Directory (optional) when you add it.
  • The Download directory field in Settings → Files & storage changes the place of all categories at once. New torrents get their category folders in the new directory, and the data you already downloaded stay where they are.

Rtorrent 16 guide: Schemas and automation · Rtorrent 16 guide: Torrents

How do I add torrents without opening the panel?

Symptoms

  • You do not want to sign in to the panel every time you add a torrent.
  • You want to add torrents from your phone or straight from the browser.

Cause

Rtorrent 16 runs on the NAS while the panel is closed. It adds and starts every .torrent file that you copy into the watch folder. The Rtorrent 16 app for Android also takes torrents, and so does a browser extension once the Gopeed add-on is installed.

Resolution

  1. Find the watch folder: on the Diagnostics page, the Watch folders card shows its path. By default it is watch/ in the base folder: in the Rdownload16 share, or in Download/rtorrent16 or Public/rtorrent16 when there is no such share.
  2. Copy a .torrent file into that folder, for example over the network share or with File Station. A file in a subfolder such as watch/tv/ gets the category tv, and a file in watch/load/ is added stopped. A subfolder you make yourself starts working within five minutes. An added file leaves the folder. If a file stays, the Watch folders card lists it under Not added with the reason.
  3. On an Android phone, install the app from the Phone app page and pair it with the NAS. Then share a .torrent file or a magnet link to the Rtorrent 16 app from another app. While the app is closed, the NAS adds the torrent at once with the category it guesses from the name, and the phone shows what was added.
  4. When the Gopeed add-on is installed on the NAS, the Add torrent page has a Browser integration card. Install the Gopeed extension for Chrome, Edge or Firefox from there, and enter the Server address and the Token from that card in the extension's settings. The extension sends torrents and magnet links to Rtorrent 16.

Tips

  • While the panel is open, paste a magnet link or a .torrent file with Ctrl+V on any page, or drop it on the page. A window titled Add from clipboard or Add torrents opens: check the queue and press Add.
  • A WhatsApp bot paired on the Notifications page and the bot of the Rtorrent 16 Telegram add-on also take a .torrent file or a magnet link sent in the chat.

Rtorrent 16 guide: Torrents · Rtorrent 16 guide: Phone app

How do I download only some files of a torrent?

Symptoms

  • A torrent has many files, and you need only a few of them.
  • You want one file to download before the others.

Cause

The box before each file of a torrent shows whether rtorrent downloads it: a ticked file downloads, an unticked file is skipped. The panel sends each change at once. You can change the order for single files only. The panel has no priority for a whole torrent, because rtorrent does not change the download order by it.

Resolution

  1. Add a .torrent file paused, so nothing downloads before you choose: on the Add torrent page, set the switch to Add paused and press Add.
  2. On Quick access, press the torrent's row, then the Files tab. A paused torrent is listed under Done and standing still. If that section is folded, press its heading.
  3. Untick the files you do not want. Largest only keeps just the largest file, and All ticks every file again. At least one file has to stay ticked.
  4. Press Start on the torrent's row.

Tips

  • On a screen wider than a phone, while more than one file is still downloading, each of them has a Download this file first button. Switched on, it shows First, and rtorrent requests that file's pieces before those of the other files.
  • A magnet link lists its files only once its metadata arrive. Untick the files when the list appears.
  • When the ticked files are done, the row reads Done: … of … files selected, and within half a minute the package handles the torrent as finished. A file you tick later downloads into the same folder.

Rtorrent 16 guide: Torrents

I deleted a torrent by mistake. How do I get it back?

Symptoms

  • A torrent left the list after you pressed Move to Trash.
  • A torrent left the list after you pressed Remove from list, and its files are still on the disk.

Cause

Move to Trash moves the torrent and its files to the Trash, and one button brings them back. Remove from list takes only the torrent off the list and leaves its files. Such a torrent comes back from the copy of the torrent list that the package takes once a day. The files are deleted for good when you press Delete or Empty Trash on the Trash page.

Resolution

  1. Open Trash in the menu. The page lists the folders in the Trash, newest first.
  2. Press Restore at your torrent. The data go back to the folder they came from, and the torrent returns to the list stopped, with its label.
  3. Find the torrent in Quick access and press Start.
  4. A torrent removed with Remove from list comes back from a copy. Open Diagnostics and, in the Backups card, press Restore the newest on the Torrent list tile. The window says how many torrents of the copy are missing from the current list.
  5. Keep Add the missing torrents selected and press Restore. rtorrent stops for the restore and starts again. Torrents already in the list stay as they are.

Tips

  • Add the missing torrents adds every torrent of the copy that the list lacks, including one you removed on purpose after the copy was taken. Remove that one again afterwards.
  • A copy holds only the torrents that were in the list when it was taken. Older copies are listed in the Backups card under the tiles, each with a restore button in its row.
  • A folder marked no record has no Restore button, because the package does not know where it came from. You can only delete it.

Rtorrent 16 guide: Torrents · Rtorrent 16 guide: The session, the configuration and their copies

How do I check a torrent's data, for example after replacing files?

Symptoms

  • You replaced or added files in a torrent's folder and want rtorrent to take them into account.
  • You suspect that a torrent's files are damaged or incomplete.

Cause

Check hash makes rtorrent read every piece of the torrent from the disk again and report how many are missing. A file that is not in the torrent's folder counts as missing pieces. After the check, the torrent goes back to the state it was in: a running torrent runs again and downloads the missing pieces of its selected files, and a stopped one stays stopped.

Resolution

  1. If nothing should download after the check, stop the torrent first with Stop.
  2. In Quick access, press the torrent's row to open it. In the Full view, open its details.
  3. Press Check hash, then Check files in the question. The torrent stops during the check, and the button fills and shows the percentage.
  4. Read the result above the torrent list: every piece is there, or the number of missing pieces, for example Missing pieces: … of ….
  5. To download the missing pieces of a stopped torrent, press Start.

Tips

  • A replaced file must be in the folder that the opened row shows as its path, under the same name as in the torrent. rtorrent counts a file under another name as missing.
  • When the torrent has .sfv or .md5 files, the button is Check files with a menu instead of Check hash. Verify checksums and Verify MD5 compare the files with those sums, keep the torrent running and change nothing. Check torrent hash is the rtorrent check described above.
  • When the check finds none of the data of a torrent that had data, the torrent stays stopped, and the result names the folder where it looked.

Rtorrent 16 guide: Torrents

How do I back up the torrent list and the settings?

Symptoms

  • You want a copy of the torrent list and the settings before you install the package again or make a bigger change.
  • You want to keep such a copy off the NAS.

Cause

The package takes two copies once a day by itself: one of the torrent list and one of the configuration. The configuration is the settings, the panel password, the tracker logins and the certificate. Neither copy holds downloaded files. By default the copies go to the backups/ folder in the base folder, which stays on the disk when you remove the package. By default the package keeps the last 14 daily copies of each kind.

Resolution

  1. Open Diagnostics. The Backups card lists every copy and the folder they go to.
  2. Press Back up now. It takes a copy of the torrent list and a copy of the configuration as they are at that moment.
  3. To keep a copy off the NAS, press the download button in its row (tooltip Download this copy). The file is rtorrent16-session-<day>.tar.gz or rtorrent16-config-<day>.tar.gz.
  4. You restore a copy in the same card: Restore the newest on a tile, or the restore button in the row of the copy you want. To bring back a torrent list from a downloaded file, press Import a copy, then restore it like any other copy.

Tips

  • The configuration copy holds the tracker logins and the panel password hash. Keep the downloaded file as safe as a password.
  • Restoring the torrent list does not change the files on disk. Restoring the configuration sets the settings, the panel password and the tracker logins back to the day of the copy, and the services restart.
  • You change the folder and the number of copies under Settings → Files & storage, in Backup folder and Backups to keep.

Rtorrent 16 guide: The session, the configuration and their copies

Speed10

Downloads are slow although my internet connection is fast

Symptoms

  • A torrent downloads much more slowly than your internet connection allows.

Cause

Rtorrent 16 does not limit speed unless you set a limit. A torrent downloads only as fast as its peers can send data. Its speed depends on how many seeders it reaches and how quickly they upload. A closed port prevents connections to peers that cannot accept incoming connections themselves.

Resolution

  1. Check the torrent's sources. In Quick access, each row shows how many seeders you are connected to and how many the tracker reports, for example 45/186. If the tracker reports only a few seeders, the torrent cannot download faster than they upload.
  2. Check the port. Open Network & NAT and press Check TCP port. The card should read IPv4 TCP port … open. If it reads not reachable, forward that port on your router to the NAS.
  3. Check the speed limits. At the top of Quick access, the line under Download and Upload reads unlimited or limit …. Click the displayed speed to change the limit.
  4. Test the link and disk. Open Performance, select Link and disk under What to test, then press Run test. The result shows the measured speeds of the link and disk and proposes settings. The test changes nothing until you apply a proposal.

Tips

  • When you switch on Turtle mode on the Dashboard, its lower limits apply.
  • With a VPN, peers can reach you only through a port provided by the VPN. Forwarding a port on your router does not open that port.

Rtorrent 16 guide: Ports

The speed chart shows more than my link, upload while no torrent uploads, or a slow climb

Symptoms

  • The Traffic card on the Dashboard shows more traffic than your internet connection can carry.
  • The chart shows upload while no torrent uploads.
  • A new torrent takes a while to reach its full speed.

Cause

The Download and Upload tiles, the coloured areas of the Traffic card, Quick access and the phone app show only the traffic rtorrent moves to and from its peers. Copies, backups and other programs on the NAS are not included in these figures.

Behind the coloured areas, the Traffic card draws a hatched band showing all traffic on the network interface Rtorrent 16 uses. This includes packet headers and acknowledgements, DHT and trackers, and traffic from every other program on the NAS. A copy to a computer at home crosses that interface but not your internet connection, so the band can show more than your link. Upload with no torrent uploading is traffic in that band.

Each speed figure is averaged over the seconds during which data has been moving: at least 3 and at most the last 60. A new transfer therefore appears within a few seconds. A slow climb depends on the swarm. A new torrent has no peers yet. While downloading, it connects to the peers its trackers return until it has as many as it asks each tracker for: 100 on the Public connection profile and 50 on the Private one by default. Each peer decides when and how much data to send.

Resolution

  1. Read the key of the Traffic card on the Dashboard. Rtorrent 16 is shown in colour; All traffic on … is the hatched band. Point at the chart, or touch it, to read both values at one moment.
  2. If the band is much wider than the colour, another program on the NAS is moving data: a copy to or from a computer, a backup, a sync job or a media server.
  3. Compare these figures with your link. On the Dashboard, the Link chart of the Performance card shows Incoming and Outgoing traffic on the same interface, with the link limits from the last test. To measure the link, open Performance, select Link under What to test and press Run test.
  4. For a slow climb, check the torrent's sources. In Quick access, each row shows how many seeders you are connected to and how many the tracker reports.

Tips

  • During a fast download, the NAS sends acknowledgements at about 1 % of the download speed, so the upload half shows a thin band.

Rtorrent 16 guide: Control Center

A download starts fast, then crawls at a few KiB/s

Symptoms

  • A torrent downloads fast at first, then drops to a few KiB/s and stays there.
  • The torrent holds many peers, but almost none of them send anything.

Cause

A downloading torrent connects to new peers on its own only while it has fewer than its minimum number of peers. Above that minimum, it only accepts peers that connect to it, up to its maximum. A peer that stays connected but sends nothing still occupies its place. When such peers fill the torrent, its speed falls even if faster sources are available.

Rtorrent 16 has peer rules to prevent this, and they are on by default. A downloading torrent closes peers that have left it waiting for 5 minutes. When a download is stuck (two checks in a row brought less than a tenth of its best check in the last ten minutes, or less than 2 KiB/s), it closes them after 90 seconds. A closed peer cannot connect again for 30 minutes. Every 30 seconds, a torrent with all its download slots taken gives the slots held by its slowest senders to waiting peers.

Resolution

  1. Check the torrent's sources. In Quick access, the row shows how many seeders you are connected to and how many the tracker reports. When only a few seeders are left in the swarm, the speed stays low with any setting.
  2. Check the peer rules. Open Settings → Connection profiles and press Custom. Under Peer rules, Close peers that keep a download waiting, Close idle peers sooner while a download is stuck and Rotate a full set of download slots should be on. If a switch reads rtorrent runs …: a line of your own in rtorrent.rc sets it, a line that you added to rtorrent.rc sets its value.
  3. If peers that send very little are holding the torrent back, open Settings → Connection and, under Slow peers, turn on Disconnect very slow peers (off by default). Every 5 minutes it disconnects up to 5 peers slower than Slow below (KiB/s) from a download that has its full number of peers while others wait. They can connect again. Compare the speeds of your torrents before you leave it on.

Tips

With rtorrent log level set to notice (the default), rtorrent.log gets a line with "dropped … idle peers" each time the first rule closes peers. Open it in Diagnostics, under Logs.

Rtorrent 16 guide: Public and private connection profiles

Upload and seeding are slow, and my ratio does not grow

Symptoms

  • Finished torrents upload little or nothing.
  • The ratio of a torrent stays low.
  • A seeding torrent stops by itself after some days.

Cause

A finished torrent uploads data only to peers that are still downloading it. When most of the swarm already has the data, there is little left to send. A closed port prevents connections to peers that cannot accept incoming connections themselves.

Rtorrent 16 also stops seeding by rule. On Seeding & Retention, the rule for public torrents is on by default: a public torrent stops when its ratio reaches 2.0 or 7 days after it completed, whichever comes first. The rule for private torrents is off by default.

Each torrent uploads to at most 30 peers at once on the Public connection profile and 15 on the Private one, and all torrents together to at most 150. Upload speed is unlimited unless you set a limit or switch on Turtle mode.

Resolution

  1. Check the seeding rule. Open Seeding & Retention. Under Public torrents, Apply rule to public torrents is on, and the Public: apply action when row holds target ratio (%) 200, upload target (MiB) 0 and days since completion 7. Reaching any target triggers the action, and 0 turns that target off. To seed longer, raise the targets or turn the rule off, then press Review & save.
  2. Check who is requesting the torrent. In Quick access, point at the seeder figure of the row: the tooltip also names the connected leechers and the leechers the tracker reports. With few leechers, there is little to upload.
  3. Check the port. Open Network & NAT and press Check TCP port. The card should read IPv4 TCP port … open.
  4. Check the upload limit. At the top of Quick access, the line under Upload reads unlimited or limit …. On the Dashboard, Turtle mode should be off.
  5. To upload to more peers at once, open Settings → Connection profiles, press Custom and raise upload in the Public profile: slots per torrent or Private profile: slots per torrent row. The total for all torrents is upload in the Global slots row of Settings → Bandwidth & limits, with Advanced on.

Tips

  • A slot is a peer the torrent may upload to at this moment. More slots do not make a peer download faster.
  • With the Night action Lowest upload, downloads go on, rtorrent uploads at 1 KB/s at night.

Rtorrent 16 guide: Seeding & Retention

Why so few peers and slots? Can I raise them?

Symptoms

  • A torrent holds fewer peers than the tracker reports.
  • Only some of the connected peers send or receive data at the same time.

Cause

Each torrent runs on the Public or the Private connection profile, chosen by the private flag in the .torrent file. Each profile sets how many peers a torrent holds, how many it uploads to and downloads from at once (its slots), and how many peers it asks each tracker for.

By default a public torrent holds 40 to 200 peers with 30 upload and 30 download slots, and asks each tracker for 100. A private one holds 20 to 100 peers with 15 upload and 100 download slots, and asks for 50. All torrents together have at most 150 upload and 100 download slots.

A slot is a peer that may transfer data at this moment. The numbers are maximums: in a small swarm, a torrent has fewer peers.

Resolution

  1. See what rtorrent runs. On the Dashboard, the Peers and their limits card shows the connected peers, the busiest torrent and rtorrent sockets: … of …. Turn on Advanced at the top of the page to see every value in the columns Now, Set and Default.
  2. Pick the profile for your line. Open Settings → Connection profiles and press 1 Gbps, 2.5 Gbps or 10 Gbps. The confirmation lists the old and new value for every change. Press Apply. The same choice is in the link profile chip of the Peers and their limits card.
  3. Or set the numbers yourself. In Settings → Connection profiles, press Custom. Change min and max in the Public profile: peers per torrent row, upload and download in the Public profile: slots per torrent row, and Public: peers each tracker is asked for. The Private profile has the same fields. Press Review & save and confirm the changes in the window that opens. rtorrent applies them without a restart.
  4. The totals for all torrents are in the Global slots row of Settings → Bandwidth & limits, with Advanced on.

Tips

  • A link profile also sets the piece cache and both speed limits for a line of that speed. On a line with a slower upload, check the upload limit after you apply a profile.
  • Each connection uses processor time and memory on the NAS, and your router handles each one.

Rtorrent 16 guide: Public and private connection profiles

The disk works all the time while Rtorrent 16 downloads or seeds

Symptoms

  • The NAS disks are busy or audible while torrents run, also when they only seed.
  • The disks never go quiet, even at night.

Cause

A download writes every piece it receives to disk. Seeding reads from disk each piece that a peer requests, so a torrent that uploads to many peers reads all the time.

Rtorrent 16 also writes its own files. rtorrent saves its session every 15 minutes, and the watchdog writes a few log lines every five minutes. By default, both are kept on the volume where Rtorrent 16 is installed.

The settings in step 2 change how much the disks work. Their defaults keep it low.

Resolution

  1. See how busy the disk is. On the Dashboard, the Performance card draws Disk response time for the volume the running downloads write to, with the Utilization of its busiest disk.
  2. Check the disk settings. Open Settings → Files & storage and turn on Advanced at the top. Under Disk I/O, pre-allocate files and re-hash on completion should be off, and Preload pieces before uploading should read Read into memory.
  3. Keep the package's own files on a less busy disk. On the same page, Where logs, settings and temporary files are kept and Where rtorrent keeps its session read With the package by default: the volume where Rtorrent 16 is installed. When Rtorrent 16 is installed on an SSD beside spinning data disks, this keeps the writes off the data disks. To use another folder, pick A directory I choose and its folder. Press Review & save and confirm. rtorrent stops while the files move and starts again.
  4. Pause torrents at night. Open Settings → Date & time, turn on Night mode, set the hours and pick Pause every torrent as the Night action.

Tips

  • A lower upload limit or fewer seeding torrents means fewer reads.
  • With Copy as the Action for completed downloads, each finished download is written a second time. The default, Hardlink: the same data, no extra space (a copy across volumes), writes nothing new on the same volume.

Rtorrent 16 guide: Control Center

Rtorrent 16 uses a lot of memory

Symptoms

  • The NAS shows high memory use while Rtorrent 16 runs.
  • The memory figure of rtorrent grows while torrents download or seed.

Cause

rtorrent maps the parts of torrent files it reads and writes into memory: its piece cache. A limit caps it. By default, the limit is a quarter of the NAS's RAM, at least 512 and at most 2048 MiB. These mapped pages are disk cache: the system frees them when another program needs the memory, and rtorrent then reads them from disk again.

rtorrent also uses memory for its peers, trackers and session. Each connection uses memory, so more peers and slots use more memory.

Resolution

  1. See what uses the memory. On the Dashboard, the Memory chart of the Processor and memory card shows what each program holds itself: rtorrent, Services and add-ons and Jobs. Mapped files in the key is the part rtorrent has mapped. The grey hatched background shows the whole NAS, without the disk cache.
  2. Read the piece cache. At the bottom of the Processor and memory card, Piece cache shows the memory in use and the limit.
  3. Lower the limit. Open Settings → Bandwidth & limits. In the Memory and files row, lower piece cache (MiB). 512 is the lowest value. Press Review & save and confirm the changes in the window that opens. rtorrent applies the new limit without a restart.
  4. Hold fewer peers. Lower max in the Public profile: peers per torrent and Private profile: peers per torrent rows of Settings → Connection profiles (press Custom to see them).

Tips

  • The memory figure of rtorrent on the Services card includes the mapped files, so it reads higher than the chart.
  • On QuTS hero, the key also shows ZFS cache: memory the system keeps for reading files and gives back when programs need it. It does not count as memory in use in the NAS figure.
  • A link profile and the proposals on the Performance page can change the piece cache. Both show the old and new value before anything changes.
  • A small piece cache can slow down downloads on a fast line.

Rtorrent 16 guide: Control Center

How do I limit how many torrents download at once?

Symptoms

  • Many torrents download at the same time and share the speed.
  • You want new downloads to wait until earlier ones finish.

Cause

Without a limit, every started torrent downloads at once. The limit is experimental: Max active downloads (experimental). It appears only in Developer mode and carries a Not recommended badge. Queued downloads wait even while running ones barely move, so a few slow torrents can hold up the rest. With Developer mode off, the limit has no effect, whatever number is set.

Resolution

  1. Open Settings and turn on Advanced at the top.
  2. Open Settings → Advanced and, under Panel, turn on Developer mode.
  3. Open Settings → Bandwidth & limits. Under Slots and memory, Max active downloads (experimental) appears. Type how many torrents may download at once. 0 means no limit.
  4. Press Review & save and confirm the changes in the window that opens. The limit applies without a restart.

Tips

  • Downloads over the limit show queued in Quick access. A queued download starts by itself when another download finishes, stops or is removed, and immediately when you raise the number or turn Developer mode off.
  • The limit does not apply to seeding torrents.
  • Turning Developer mode off also turns auto-tuning off and starts every queued download.

Rtorrent 16 guide: Torrents · Rtorrent 16 guide: Auto-tuning

How do speed limits, Turtle mode and the Performance proposals work?

Symptoms

  • You want to limit how fast Rtorrent 16 downloads or uploads.
  • You are not sure what Turtle mode or the proposals of the Performance page change.

Cause

Rtorrent 16 has two overall limits, one for download and one for upload, in KiB/s. Both are 0 by default, which means unlimited. Turtle mode replaces both with its own lower limits, 2048 KiB/s for download and 512 KiB/s for upload by default. When you switch it off, the normal limits come back. The Performance page measures your link and proposes limits based on the measurement. Nothing changes until you apply a proposal.

Resolution

  1. Change a limit quickly. At the top of Quick access or the Dashboard, click the Download or Upload figure, type the limit in KiB/s (0 = no limit) and press Save limits. The limit stays after a restart.
  2. Or open Settings → Bandwidth & limits. Under Speed, set download and upload in the Max speed (KiB/s, 0 = unlimited) row, and Turtle mode's own limits in the Turtle mode limit (KiB/s) row. Press Review & save and confirm the changes in the window that opens.
  3. Slow everything down for a while. On the Dashboard, press Turtle mode. Press the button again to switch it off.
  4. Let the Performance page propose limits. Open Performance, select Link under What to test and press Run test. Turn on Advanced at the top of the page. Under Proposed settings, each row shows the current value, the proposed value and the reason. Tick the rows you want, set Headroom left for other traffic, and press Apply settings (…).

Tips

  • The proposed limit is the measured speed less the headroom. The headroom is 2 % by default and 1 to 10 % with the slider, and it is at least 1 Mbit/s and at most 50 Mbit/s. If you type the speeds of your plan before the test, the proposals use the lower of the plan and the measurement.
  • Turtle mode lasts until you switch it off or rtorrent restarts.
  • A link profile on the Peers and their limits card also sets both limits, for a line of that speed in both directions.

Rtorrent 16 guide: Performance tests

Connections, trackers and privacy7

My internet stops working, or my router hangs, while Rtorrent 16 is running

Symptoms

  • Web pages stop loading, or the router stops responding, while torrents are running.
  • Everything works again after you stop the torrents.

Cause

Rtorrent 16 does not limit the total number of connections. Each public torrent can connect to up to 200 peers, and each private torrent to up to 100. Ten active public torrents can therefore hold up to 2,000 connections at once. A router or modem that cannot handle that many connections slows down or stops responding. Upload speed is also unlimited by default.

Resolution

  1. Check how many connections rtorrent has open. The Peers and their limits card on the Dashboard shows rtorrent sockets: … of ….
  2. Lower the number of peers per torrent. Open Settings → Connection profiles and press Custom. In the Public profile: peers per torrent row, lower max (200 by default), for example to 50. If you use private trackers, do the same in the Private profile: peers per torrent row. Press Review & save and confirm the changes in the window that opens. The new limit takes effect without restarting rtorrent.
  3. Limit uploading. Click the Upload speed at the top of Quick access and set a limit below the upload speed of your internet plan.
  4. Check rtorrent sockets on the Dashboard again.

Tips

Fewer active torrents also mean fewer connections. Stop the torrents you do not need right now.

Rtorrent 16 guide: Public and private connection profiles

Rtorrent 16 fills my upload and everything else on the internet lags

Symptoms

  • Web pages, video calls or games slow down while torrents seed or download.
  • The Upload figure stays close to the upload speed of your internet plan.

Cause

Upload speed is unlimited by default. On a line whose upload is much slower than its download, torrents can use all the upload, leaving other devices and programs on your network with what remains.

A link profile does not account for a slower upload. The 1 Gbps profile sets the upload limit for a 1000 Mbit/s upload, so on a slower line it limits nothing.

Resolution

  1. Set an upload limit below your plan's upload speed. At the top of Quick access, click the Upload figure, type the limit in KiB/s and press Save limits. 1 Mbit/s is about 122 KiB/s, so a 40 Mbit/s upload is about 4880 KiB/s. The limit stays after a restart.
  2. Or let the Performance page propose the limit. Open Performance, select Link under What to test, type the speeds of your plan if you know them, and press Run test. Turn on Advanced at the top of the page. Under Proposed settings, tick Max upload rate (KiB/s, 0 = unlimited). The Headroom left for other traffic slider sets how much of the measured upload stays free, up to 10 %. Press Apply settings (…).
  3. If other traffic still stutters while the torrents run at full speed, lower the limit further.
  4. For a short break, press Turtle mode on the Dashboard. It limits upload to 512 KiB/s by default. Press it again to switch it off.

Tips

  • The proposal keeps at least 1 Mbit/s and at most 50 Mbit/s free. On a 40 Mbit/s upload, 2 % is less than 1 Mbit/s, so 1 Mbit/s stays free; at 10 %, 4 Mbit/s.
  • The upload limit covers rtorrent only. A backup or a sync job on the NAS that sends to the internet is not limited by it. The hatched band of the Traffic card on the Dashboard shows all traffic on the interface.
  • With the Night action Lowest upload, downloads go on, rtorrent uploads at 1 KB/s at night.

Rtorrent 16 guide: Performance tests

My provider blocked my line or my MAC address. What does Rtorrent 16 send?

Symptoms

  • Your internet provider blocked your line or the MAC address of your router or NAS while Rtorrent 16 was running.
  • You want to know what Rtorrent 16 sends, and to whom.

Cause

Rtorrent 16 does not set or change a MAC address. It sends BitTorrent traffic to peers and trackers, and port forwarding requests to your router.

Peers reach rtorrent on one port over TCP and UDP, by default from the range 50000-50010. rtorrent also connects to peers itself. By default, each public torrent can have up to 200 peers and each private torrent up to 100. There is no limit on the total number of peers, and upload is unlimited by default. rtorrent announces each running torrent to the trackers listed in it. With the default settings, a public torrent also gets up to 16 addresses from the public tracker list, split into four groups, and rtorrent asks one tracker from each group for peers. For public torrents only, DHT runs on UDP port 6891 by default, and peer exchange shares peer addresses with connected peers.

With UPnP and PCP / NAT-PMP on (the default), the package asks your router to forward the BitTorrent port and the DHT port. It asks for the panel's ports only when you switch that on, and for the phone apps' port only while remote access for the phone apps is on.

Resolution

  1. Check the ports. Open Network & NAT. The Network services table lists BitTorrent (TCP peers), BitTorrent (uTP) and DHT with their ports, and Mapped as shows what the router forwarded.
  2. Check the connections. The Peers and their limits card on the Dashboard shows rtorrent sockets: … of …. To lower the number, open Settings → Connection profiles, press Custom and lower max in the Public profile: peers per torrent row.
  3. Limit uploading. Click the Upload speed at the top of Quick access and set a limit below the upload speed of your internet plan.
  4. Send less for public torrents. In Settings → Connection, set DHT to Off (can be enabled at runtime). Switch on Advanced and set Add public trackers to new public torrents to Off. Press Review & save and confirm the changes.

Tips

If your provider names a port or a protocol, compare it with the ports on Network & NAT.

Rtorrent 16 guide: Ports

Does Rtorrent 16 add public trackers to my torrents? How do I turn it off?

Symptoms

  • A public torrent lists more trackers than its .torrent file has.
  • You want to know which torrents get these trackers and how to stop it.

Cause

Rtorrent 16 keeps a list of public trackers and adds it to every new torrent that rtorrent reports as not private. Private torrents do not get it. A torrent uses the first 16 addresses on the list, split into four groups, and rtorrent asks one tracker from each group for peers. Addresses this NAS cannot reach (.i2p, .onion, .local) are disabled for that torrent. The package downloads the list again once a day. A public torrent you create on the NAS gets the list in rtorrent as well, but its .torrent file keeps only the trackers you entered.

Resolution

  1. Open Settings → Connection and switch on Advanced at the top of the page.
  2. Under Public trackers, set Add public trackers to new public torrents to Off.
  3. Press Review & save and confirm the change in the window that opens. No restart is needed. Torrents you add after that keep only their own trackers.
  4. A torrent added earlier keeps the addresses it got. To switch them off, right-click the torrent in Quick access or Full view and choose Properties / Edit task settings. Untick the trackers you do not want and press Save tracker changes. A row marked Read only cannot be changed there.

Tips

  • The private flag in the .torrent file decides this. A public torrent on the Private profile still gets the list; a private torrent on the Public profile does not.
  • To use a list of your own, choose A list at the URL below and type its address in Tracker list URL. A list with fewer than 5 usable lines is refused, and the previous list stays.

Rtorrent 16 guide: Public and private connection profiles

Private trackers: do I have to turn off DHT and peer exchange?

Symptoms

  • Your private tracker's rules say that DHT and peer exchange (PEX) must be off.
  • In Settings → Connection, DHT is set to On.

Cause

A torrent from a private tracker has the private flag in its .torrent file. For a torrent with this flag, rtorrent never uses DHT or peer exchange. It does not announce the torrent to DHT or look for peers there, and peer exchange stays off. This applies in every DHT mode, so the DHT setting affects public torrents only. Rtorrent 16 also never adds its list of public trackers to a private torrent.

Resolution

  1. To read the help, open Settings → Connection. Under DHT and peer exchange, click the question mark next to mode. The help reads: "Finds peers for public torrents without a tracker. Never used for private torrents."
  2. If you also download public torrents, leave mode on On. Public torrents use DHT to find peers.
  3. If you still want DHT off, set mode to Off (can be enabled at runtime) or Disabled. Press Review & save and confirm the change in the window that opens. Private torrents work the same either way.

Tips

  • The private flag decides this. A tracker host that you add under Overrides by tracker host in Settings → Connection profiles (shown after you turn on Advanced at the top of Settings) changes only the peer limits and the seeding rule. A torrent without the private flag keeps DHT, peer exchange and the public tracker list.
  • Peer exchange (PEX) and Add public trackers to new public torrents appear in Settings → Connection after you turn on Advanced. Neither can be set for a single torrent.

Rtorrent 16 guide: Public and private connection profiles

Does protocol encryption hide what I download?

Symptoms

  • You want to keep your torrent traffic private and look at the encryption setting.
  • You wonder whether encryption hides your address or what you download.

Cause

Protocol encryption covers the connections between rtorrent and its peers: the handshake and the data stream. Requests to trackers are outside this setting. By default, rtorrent prefers encrypted connections and falls back to plain ones. Encryption does not hide your IP address or guarantee anonymity. If you require encryption, fewer peers can connect.

Resolution

  1. Open Settings → Connection and switch on Advanced at the top of the page.
  2. Under Protocol, in the Encryption and type of service row, find protocol encryption. The default is Prefer encrypted, fall back to plaintext (recommended).
  3. Choose Require encryption only if you accept fewer peers. Off (plaintext only) turns encryption off.
  4. Press Review & save and confirm the change in the window that opens. rtorrent takes the new value without a restart.

Tips

When the NAS goes to the internet through a VPN, peers see the VPN's address instead of yours. They can reach you only through a port the VPN service forwards to you; the Ports guide has the settings.

Rtorrent 16 guide: Ports

Should I turn on the IP blocklist?

Symptoms

  • You see Settings → Blocklist and do not know whether to switch it on.

Cause

The blocklist is off by default. When it is on, rtorrent blocks peers whose IPv4 address is on a list of address ranges. IPv6 peers pass, and every peer outside the list connects as before. The package downloads the list from the address in Blocklist URL (P2P/CIDR, .gz allowed). While the switch is on, it downloads the list again once a day. A failed download leaves the previous list in place.

Resolution

  1. To use it, open Settings → Blocklist and switch on Enable IP blocklist. The address below it points to a default list; you can type the address of another list.
  2. Press Review & save and confirm the change in the window that opens. The page shows Needs an rtorrent restart. Press Apply now.
  3. Open Diagnostics and press Download blocklist & load in the Maintenance card. The line under the button reads Address ranges loaded in rtorrent: ….

Tips

  • To turn the blocklist off, switch it off, save and press Apply now. rtorrent keeps a loaded list until it restarts.
  • The package keeps a downloaded list only when it holds IPv4 ranges: two addresses joined by a dash, for example 192.0.2.0-192.0.2.255, or a CIDR block at the start of a line, for example 192.0.2.0/24. A file with neither is refused, and the previous list stays.

Rtorrent 16 guide: Ports

Ports, VPN and the router8

Do I have to open the port on my router by hand? Does a closed port slow me down?

Symptoms

  • Network & NAT shows IPv4 TCP port … not reachable.
  • You are not sure whether you have to forward the port on your router yourself.

Cause

Peers connect to rtorrent through one BitTorrent port over TCP and UDP, and to DHT through one UDP port. If the port is closed, rtorrent still connects to peers itself, but fewer peers can connect to you. A closed port prevents connections to peers that cannot accept incoming connections themselves. By default, Rtorrent 16 asks the router over UPnP and PCP / NAT-PMP to map the BitTorrent port (TCP and UDP) and the DHT port (UDP). It makes these requests at every start and after you save a port setting. If the router accepts them, you do not have to forward anything by hand.

Resolution

  1. Check the port. Open Network & NAT and press Check TCP port. If the BitTorrent port card reads IPv4 TCP port … open, you do not need to do anything.
  2. Check what the router mapped. In the Network services card on the same page, Mapped as shows what the router granted, and By shows which method was used. Not mapped means that the router mapped nothing for that port.
  3. Check the switches. In Settings → Port forwarding & VPN, under Router port mappings, UPnP and PCP / NAT-PMP should both be on. UPnP or PCP / NAT-PMP must also be on in the router itself. While a port is not mapped, Rtorrent 16 asks the router again every five minutes.
  4. If the router does not map the ports, forward them manually: the BitTorrent port over TCP and UDP, and the DHT port over UDP, to the NAS's LAN address. The numbers are in the Port column of Network services. Then press Check TCP port again.

Tips

  • A port forwarded manually works while the switches are on, but it does not appear under Mapped as.
  • If Route to the internet shows Possible multiple routers or Another NAT likely before your router (IPv4), a forward on your own router alone may not open the port. The card lists what to do.

Rtorrent 16 guide: Ports

The port is open after a start, but closed some hours later

Symptoms

  • After Rtorrent 16 starts, Network & NAT shows IPv4 TCP port … open.
  • Some hours later, it shows IPv4 TCP port … not reachable.

Cause

A router keeps an automatic port mapping only for a limited time. Rtorrent 16 requests a PCP or NAT-PMP mapping for one hour. A UPnP mapping lasts until the router forgets it, for example when the router restarts. Every five minutes, the Rtorrent 16 watchdog checks the mappings. With PCP / NAT-PMP on, it requests every mapping again for another hour. With only UPnP on, it reads the router's UPnP table and requests again any mapping that the router no longer has. A lost mapping therefore returns within five minutes if the router accepts the request.

Resolution

  1. Check the switches. In Settings → Port forwarding & VPN, under Router port mappings, enable PCP / NAT-PMP and UPnP if your router supports them. Both are on by default.
  2. Wait up to five minutes. Then open Network & NAT and press Check TCP port. Mapped as in the Network services card shows what the router granted.
  3. Read the log. Open Diagnostics and select service under File in the Logs card. With only UPnP on, a lost mapping leaves a line such as "port forwarding: the router no longer had the UPnP mapping for …; mapped again". If the line ends with "not mapped again", the router refused the new request.
  4. If the router keeps refusing, forward the ports manually on the router: the BitTorrent port over TCP and UDP, and the DHT port over UDP, to the NAS's LAN address.

Tips

  • When you stop Rtorrent 16, it removes the mappings it made. It requests them again at the next start.
  • The QNAP System Logs get a port forwarding line only when something changes, for example when the router starts refusing a mapping.

Rtorrent 16 guide: Ports

Network & NAT shows another port than the one my router forwards

Symptoms

  • Network & NAT shows another port than the one you forwarded on the router.
  • The Dashboard shows a red badge such as Port … was busy · running on …, or the DHT port reads (moved from …).

Cause

Network & NAT shows the port that rtorrent really listens on. The saved setting is a range, 50000-50010 by default, and rtorrent listens on one port in that range. With Pick a random port from the range on, that port changes at every start. If other programs hold every port in the saved range when rtorrent starts, rtorrent takes the nearest free port within the 20 ports above the range for that start only. The saved setting stays the same, and the next start tries it again. The DHT port also moves when another program holds it, to the first free UDP port above the saved one. In both cases, with UPnP or PCP / NAT-PMP on, Rtorrent 16 asks the router to forward the new port. With Ask the VPN for an incoming port on, rtorrent listens on the port that the VPN gave.

Resolution

  1. See the ports in use. On the Dashboard, the Network card shows Listening port and DHT port. A moved port shows (moved from …) after the number. Hover over the red badge to see which program holds the saved port.
  2. Set the port that your router forwards. Open Settings → Connection. With Pick a random port from the range off, the field reads Listening port (1024-65535). Enter the forwarded port; for example, 42000 saves the range 42000-42000. Alternatively, forward the whole range on the router. Press Review & save and confirm the change. If a notice says that a restart is needed, press Apply now.
  3. If another program holds the port, stop that program. The next start of rtorrent takes the saved port again.
  4. Open Network & NAT and press Check TCP port.

Tips

  • In the Network services card, two numbers under Mapped as (… → …) mean that the router gave another outside port. Use the same port on both sides.
  • If Settings shows the red notice "rtorrent currently listens on port …. Saved port range: …. Saved changes may still need a restart.", the notice only compares the two ports. It does not tell why they differ.

Rtorrent 16 guide: Ports

What do the colours on Network & NAT mean?

Symptoms

  • Network & NAT shows green, orange, red and grey marks, and you do not know which of them need action.

Cause

The page has three cards, and each one marks its own checks. Green means that a check passed. Orange means that something needs a check. Red means that a check failed. Grey means that a check got no answer or did not run. In the Mapped as column, the words tell the result. These are the colours of the default theme. Other themes use their own shades.

Resolution

  1. Read Route to the internet. The box at the top is green when nothing is in the way, for example with Peers can reach this NAS. An orange box, such as Possible multiple routers, names something to check: a second router, or a port that is closed. A red box, Another NAT likely before your router (IPv4), means that a forward on your router alone may not help. The box lists what to do.
  2. Read BitTorrent port. The line at the top is green for IPv4 TCP port … open, red for IPv4 TCP port … not reachable, and orange for IPv4 TCP port … unverified when no checker on the internet answered. Under it, each of the four steps has a green tick (passed), a red cross (failed) or a grey question mark (no answer).
  3. Read Network services. Under Mapped as, same port means that the router mapped the port under the same number, and Not mapped means that it mapped nothing. In the default theme, both are grey. Two numbers in orange (… → …) mean that the router gave another outside port; use the same port on both sides. Under From the internet, a TCP row shows green open, red not reachable or grey unverified. UDP rows show not tested.

Tips

The last step, External IPv4 TCP check, tells you whether peers on the internet can reach the port. A red Router mapping list alone does not indicate a fault, because a port forwarded manually never shows in that list. A grey Router loopback is not a fault either: many routers refuse loopback connections.

Rtorrent 16 guide: Ports

Is UPnP safe, and which ports does Rtorrent 16 open on my router?

Symptoms

  • The router's list of UPnP mappings shows entries with the description "Rtorrent 16".
  • You want to know what Rtorrent 16 asks the router for before you leave UPnP on.

Cause

By default, UPnP and PCP / NAT-PMP are on, so Rtorrent 16 asks the router to forward ports to the NAS's LAN address. It asks for the BitTorrent port (TCP and UDP) and, while DHT is on, the DHT port (UDP). It asks for the panel's ports (TCP) only if you turn on WebUI ports, which is off by default. It asks for the mobile port (TCP) while Remote access for the phone apps is on, unless you turn off Mobile ports. Only paired phones get an answer on that port. When Network & NAT finds a second router in front of yours, Rtorrent 16 also asks that router for the same ports over PCP or NAT-PMP. When you stop Rtorrent 16, it removes the mappings it made.

Resolution

  1. See what the router granted. Open Network & NAT. In the Network services card, Mapped as shows each mapping, and By shows the method.
  2. Check the switches. Open Settings → Port forwarding & VPN and look under Router port mappings. Leave WebUI ports off unless you need the panel from the internet. Its help warns: "Can expose the panel's login to the internet. Set your own password first."
  3. If you do not want automatic mappings, disable UPnP and PCP / NAT-PMP. Press Review & save and confirm the changes. Rtorrent 16 then removes the mappings it made. Forward the BitTorrent port (TCP and UDP) and the DHT port (UDP) manually on the router instead.

Tips

  • When Rtorrent 16 requests its own Let's Encrypt certificate for the panel and port 80 is not forwarded yet, it asks the router to forward TCP port 80 to the NAS while the request runs. It removes the mapping afterwards. With both switches off, it does not ask the router for port 80.
  • Knock knock on the WhatsApp and Telegram pages is off until you turn it on. While it is on, writing "knock knock" to the bot maps a random port to the panel's https port for a few minutes.

Rtorrent 16 guide: Ports

My NAS goes to the internet through a VPN. Can peers reach it, and is it slower?

Symptoms

  • Network & NAT shows IPv4 TCP port … not reachable, although the port is forwarded on your router.
  • Route to the internet shows Another NAT likely before your router (IPv4).

Cause

Behind a VPN, peers see the address of the VPN. They can reach you only through a port that the VPN service forwards to you. A port forwarded on your own router does not open that port. When the NAS sends its own traffic through the VPN, Network & NAT shows Another NAT likely before your router (IPv4), because your router's WAN address differs from the public IP.

Resolution

  1. If the VPN runs on the NAS, bind rtorrent to the tunnel. Open Settings → Connection, press Choose next to Bind to interface / IP, then press Use this interface on the tunnel's row. Choose the tunnel by its name: the binding then follows address changes and turns on the kill-switch.
  2. Get an incoming port. In Settings → Port forwarding & VPN, set Ask the VPN for an incoming port. If your VPN service is the one named in the automatic option, choose that option. It asks the tunnel's gateway for a port over NAT-PMP and renews it every 45 seconds. Otherwise choose Manual: I have a port from my provider and type the port in port your VPN gave you. rtorrent then listens on that port.
  3. Press Review & save and confirm the changes. Then press Apply now to restart rtorrent.
  4. Open Network & NAT and press Check TCP port. The check tests the port on the address shown as Public IP on that page. It tests the VPN's port only if that address belongs to the VPN, which is when the NAS sends its own traffic through the VPN.

Tips

  • If the VPN runs on your router, Rtorrent 16 can only ask your router for the port over UPnP or PCP / NAT-PMP. What the router does with that request depends on the router. You can also get a port from the VPN service, forward it on the router to the NAS, and choose Manual: I have a port from my provider with that port.
  • Speed: the NAS's processor encrypts all the traffic that goes through the tunnel. WireGuard needs less processor time than OpenVPN, so through OpenVPN the processor can keep the download below the speed of the line.

Rtorrent 16 guide: Ports

The VPN dropped. Did my IP address leak?

Symptoms

  • The VPN tunnel on your NAS dropped or reconnected while torrents were running.
  • On the Dashboard, the tunnel shows address unavailable, or rtorrent is stopped.

Cause

Rtorrent 16 does not monitor the VPN itself. Your address is protected by two settings: the binding and the kill-switch. When rtorrent is bound to the tunnel by name in Bind to interface / IP, it connects to peers, DHT and trackers from the tunnel's address. If the tunnel has no IPv6 address, rtorrent blocks IPv6 completely. The kill-switch checks the tunnel's address every five minutes. When the address is gone, it stops rtorrent and does not start it again while the address is missing. It starts rtorrent again at the first check that finds the address back for at least Wait after tunnel recovery (seconds), 30 seconds by default. Without the kill-switch, nothing stops rtorrent while the tunnel has no address, and a start at that moment, for example after the NAS restarts, puts rtorrent on all interfaces.

Resolution

  1. Bind rtorrent to the tunnel by name. Open Settings → Connection, press Choose next to Bind to interface / IP, then press Use this interface on the tunnel's row. An IP address typed in this field does not follow a new tunnel address and does not turn on the kill-switch.
  2. Check the kill-switch. In Settings → Port forwarding & VPN, Kill-switch: stop rtorrent when the bound interface has no address turns on when you choose an interface by name. Leave it on.
  3. Press Review & save and confirm the changes. Then press Apply now to restart rtorrent.
  4. Check the result on the Dashboard. In the Network card, Bind shows the tunnel and its address, and IPv6 reads blocked for a tunnel without IPv6. The Services card shows the tunnel with its address and … · kill-switch.

Tips

  • Up to five minutes can pass between two checks of the kill-switch. It checks only whether the tunnel has an address.
  • QTS looks up names through all its DNS servers at once, including those of your LAN. Tracker names are therefore also looked up outside the tunnel. The torrent traffic itself goes through the tunnel.

Rtorrent 16 guide: Ports

Does Rtorrent 16 work over IPv6?

Symptoms

  • Your internet connection has IPv6, and you want peers to reach the NAS over it.
  • You want to know whether Rtorrent 16 uses IPv6 at all.

Cause

Yes. With IPv6 set to Auto (allow IPv6), the default, rtorrent uses IPv4 and IPv6 at once. It listens on one port for both, and DHT keeps an IPv6 table on its own UDP port too. The package announces the NAS's stable global IPv6 address to trackers. It does not announce temporary (privacy) addresses. IPv6 needs no port forwarding. Most routers drop incoming IPv6 connections until you allow them in the router's IPv6 firewall.

Resolution

  1. Open Network & NAT and find the IPv6 block of the BitTorrent port card. Address shows the NAS's global IPv6 address. No global IPv6 address on this NAS., or a unique-local address starting with fd, means the internet cannot reach the NAS over IPv6.
  2. Check Announced to trackers: the address trackers give to IPv6 peers. Leave Announce this IPv6 to trackers in Settings → Connection empty unless trackers must get another address.
  3. Read Internet over. When the IPv6 setting does not fit what the check found, the button Set IPv6 mode to … and restart rtorrent appears under it. It saves the fitting setting and restarts rtorrent; nothing changes until you press it.
  4. In the router's IPv6 firewall, and in QuFirewall if it is on, allow incoming TCP and UDP on the BitTorrent port and UDP on the DHT port (6891 by default) to the NAS's IPv6 address.
  5. Press Check TCP port. The IPv6 block then reads open, not reachable or unverified.

Tips

  • With Off (block IPv6 entirely), or with Bind to interface / IP set to an IPv4 address or an interface without IPv6 (most VPN tunnels), rtorrent uses IPv4 only.
  • The Ports strip on Quick access shows one dot for IPv4 and one for IPv6.

Rtorrent 16 guide: Ports

Seeding4

Can I seed files I already have, downloaded earlier or with another program?

Symptoms

  • The data of a torrent are already on the NAS, downloaded earlier or with another program.
  • You want Rtorrent 16 to seed them where they are, without downloading them again.

Cause

The seed category does this. A torrent added under seed gets no folder of its own: rtorrent looks for its files in the folder you give, checks them, downloads only what is missing and seeds. The folder can be any existing folder on a share, including one outside the download folder.

Resolution

  1. In Quick access, press Add torrents. Paste the magnet link, or press Choose files and select the .torrent file.
  2. Press Queue and pick the seed category for the torrent.
  3. In Directory (optional), type the folder that holds the data. For a torrent with several files, use the folder above the torrent's own folder: for /share/Multimedia/Movies/Example.Film.2019, type /share/Multimedia/Movies. For a torrent with one file, type the folder that contains the file.
  4. Press Add …. rtorrent checks the files and starts seeding.

Tips

  • rtorrent finds the data only under the names given by the torrent. If you renamed the folder or files, rename them back first; otherwise, rtorrent downloads everything again into that folder.
  • Directory (optional) applies to the whole queue. Add torrents whose data are in different folders one at a time.
  • A seed torrent seeds quietly: no copy in the completed folder, no media library, no notification. The seeding rules apply to it as they do to any other torrent. If their selected action is Delete, data to Trash, data outside the download folders stay where they are; only the torrent is removed from the list.

Rtorrent 16 guide: Seeding & Retention

What does Super seed do?

Symptoms

  • You are the first to share a torrent, for example one you made yourself, and its first downloaders wait a long time for a full copy.
  • A complete torrent offers Super seed, and you are not sure when to use it.

Cause

Super seed is for a torrent you are the first to share. rtorrent sends each piece to one peer only and offers the next piece once the first has been seen at a second peer. This helps the swarm get its first full copies sooner than when every peer asks you for the same pieces. rtorrent ends super seed by itself once every piece has been seen at two peers, or as soon as more than one other seeder is connected. It then seeds normally.

Resolution

  1. In Quick access, click a complete torrent's row to open it, then press Super seed to the right of the Peers and Files tabs. On a phone, the button shows only its icon.
  2. Or open the Full view, click the torrent to open its details and press Super seed. For several torrents, tick them and pick Super seed under More.
  3. To end it sooner, press the same button, which now reads Super seed off. In Quick access, the button in place of Stop shows the super seed icon while it runs. Pressing it switches super seed off, and the torrent keeps seeding.

Tips

  • Switching super seed on or off while the torrent runs pauses it for a moment, and its peers connect again.
  • Super seed needs a complete torrent that is not checking its files. It stays on through a restart of rtorrent or the NAS until it ends by itself.
  • To seed data you downloaded earlier, add the torrent under the seed category. Super seed only changes how a complete torrent hands out its pieces.

Rtorrent 16 guide: Torrents

I download some torrents only to seed them. How do I keep them out of the library?

Symptoms

  • A torrent you keep only for seeding gets a copy in the completed folder or lands in the media library.
  • Its finished download sends you a notification you do not need.

Cause

What happens when a download finishes depends on its category. A torrent in the seed category (upload is the same category under a second name) seeds quietly: no copy in the completed folder, no media library, no Game Agent, no media server refresh and no notification. With the default settings, the QNAP System Logs still get its "Download finished" line.

Resolution

  1. When you add the torrent: in Quick access, press Add torrents, then Queue, and pick seed for it.
  2. For a torrent already in the list: press its label on its row in Quick access, pick seed, read the plan and press Move. Its data move into the seed category's folder. Any pending actions, such as its notification or addition to the media library, do not happen. Anything the library has already filed stays there, and the torrent's existing copy in the completed folder moves with it. Only a download that finishes under seed gets no copy.

Tips

  • Seeding rules apply to torrents in the seed category just as they do to other torrents. To keep one seeding, tick it in the Full view, press More, then Keep out of the seeding rules.
  • A label in Labels ignored by Movie Agent and FileBot (the library settings on the Media library page) keeps a download out of the library only. It still gets its copy in the completed folder and its notification.

Rtorrent 16 guide: Seeding & Retention

Can the seeding rules stop or delete torrents of one category after some days?

Symptoms

  • You want torrents of one category, for example tv, to stop or go after some days, while the others keep seeding.
  • The Seeding & Retention page has no rule per category.

Cause

There are two seeding rules: one for public torrents and one for private ones. A rule checks whether a torrent is public or private, not its category. Each rule acts on a finished torrent when the first of its conditions is reached: a ratio, an amount uploaded, or a number of days since the download finished. It then does what you picked: Pause, Stop, Remove the task or Delete, data to Trash. In a new install, the public rule is on (ratio 2.00 or 7 days, then Stop) and the private rule is off.

Resolution

  1. Open Seeding & Retention. In How seeding ends, set the rule for your torrents' kind, public or private: its ratio, uploaded and days, and the action in then. Each click on a badge saves the change immediately.
  2. Keep torrents that should continue seeding out of the rules. Open the Full view, pick their category under Label, tick them, press More (the … button beside Category) and choose Keep out of the seeding rules.
  3. To undo this, choose Back under the seeding rules in the same menu.

Tips

  • A torrent added later is under the rules until you keep it out the same way.
  • The rules are checked every 5 minutes. A rule acts on each torrent once. If you start a torrent again by hand, the rule leaves it running. After you change a rule, it applies to every torrent again.
  • Check your tracker's seeding rules before you switch the private rule on.

Rtorrent 16 guide: Seeding & Retention

The media library6

My files are in the downloads and in the library. Do they take twice the space?

Symptoms

  • The same film shows in the Download folder and in the Media Library, and for some labels in the Master Folder too.
  • You worry that each of them takes its own space.

Cause

On a single volume, the files do not take twice the space. When a download finishes, the package puts it in the Master Folder as a hardlink by default: a second name for the same data. With the media library on, Movie Agent then files the film or episode into the Media Library under its proper name. For labels in Labels whose completed copies should be moved (by default movies, tv, kids, anime and mixed), it moves the Master Folder's copy there. For other labels it follows Operation: by default, one more hardlink. Either way, the data are on disk once, and the torrent keeps seeding from the Download folder.

Resolution

  1. Open Media library. The routing diagram shows how a finished download reaches the Master Folder (hardlink, on finish) and how Movie Agent takes it into the Media Library (move here). It also shows whether those folders are on the same volume.
  2. Check a file. In Files, right-click the film and choose Properties. Names reads … names (hard links) when the same data have more than one name, and Find other names lists them. Every name shows the same Inode.

Tips

  • A hardlink cannot cross volumes. Where the routing diagram shows different volumes, each file is copied and takes up space again.
  • Deleting a download frees no space while the library still holds the same data under its own name. Storage protection on Seeding & Retention skips such torrents for that reason.

Rtorrent 16 guide: Media library

A finished download is a pile of .rar files

Symptoms

  • A finished film or series is a set of .rar files (.r00, .part01.rar and so on) instead of a video file.
  • Its row in Scraper history says Waiting for the archives to unpack or Archives not unpacked: ….

Cause

Some releases come packed in archives. rtorrent seeds them as they are, so the archives stay. While Unpack archives first is on (the default), the package unpacks a finished download in the completed folder, in every category except seed and upload, with the media library on or off. Archives among many other files, as in a program's folder, stay packed. Unpacking needs free space for the unpacked files. While the media library is on, Movie Agent waits for the unpack and then files the video. It unpacks a release that was not unpacked as it finished only when the archives hold nothing but video, pictures and an .nfo file. A disc image, other files in the archives, a password or a broken archive part leave the release packed, and the row says why.

Resolution

  1. In Quick access, press Unpack (the open box) on the finished torrent's row. The button shows only for a complete torrent with archives among its files.
  2. In the prompt, check how many archives there are, how much space the files need and how much is free. Press Unpack. Once the files are unpacked into the torrent's copy in the completed folder (the Master Folder on the Media library page), a second question offers Delete after unpacking. This permanently deletes that copy's archive parts without sending them to the Trash. The torrent keeps seeding from its own files either way.
  3. With the media library on, open Scraper, find the release's row in Scraper history and press Re-run: organise this download again (the round arrow). Movie Agent files the unpacked video.
  4. To unpack future releases automatically, keep Unpack archives first on. Find it in the library settings on the Media library page, under Organising and identification.

Tips

  • A dimmed Unpack button means unpacking is blocked, for example because a program contains many separate archives. Press it to see why; Unpack anyway bypasses that check.
  • Organise a folder manually does not unpack archives. Unpack first, then organise.

Rtorrent 16 guide: Torrents · Rtorrent 16 guide: Media library

Movie Agent shows "No main video" or "Episodes not recognised"

Symptoms

  • A release's row in Scraper history ends with No main video, and the film does not reach the library.
  • A season pack's row ends with Episodes not recognised, and the pack stays in the library under its release name.

Cause

Movie Agent files a film or series only when its video files make up at least half of the release. Extras folders (Sample, Featurettes, Extras and the like), info files, scans and subtitles do not count. Archives count only once they are unpacked. If the video files make up less than half, the row says No main video.

The season and episode numbers come from the file names: S02E01, 1x02, E05 or - 07. A file with no number is matched against the season's episode titles. A pack in which no file names an episode keeps its release name in the library. The nightly sweep tries such a pack again and, if its files still do not name any episodes, leaves it as it is with Episodes not recognised.

Resolution

  1. Open Scraper and find the row in Scraper history. Open history lists every row and has a search field.
  2. Archives: press Unpack on the torrent's row in Quick access, then Re-run: organise this download again on the history row.
  3. If the film is among larger files: in Organise a folder manually, choose One release and type the path to the film's video file itself, or pick it with Browse. Press Preview, choose Into the Media library and press Apply to ….
  4. Episodes without numbers: choose Many releases, give the path to the release's folder in the download folder and press Preview. Each video gets a row. On each row, press Edit name, set Film or series to Series, type the series' name in Title if it is empty, fill in Season and Episode and press Preview. Then choose Into the Media library and press Apply to ….

Tips

  • Re-identify changes the title, not the numbers: the season and episode numbers stay as the file names give them.
  • With the default Operation, manual filing creates hardlinks or copies on another volume, and the torrent keeps seeding.

Rtorrent 16 guide: Media library

Do I need FileBot for the media library?

Symptoms

  • You want finished films and series to go into a tidy library, and you do not have FileBot.
  • You are wondering whether to buy a FileBot licence.

Cause

You do not need it. Movie Agent, built into the package, files the library. It identifies titles, names the folders and files, and saves the poster, the backdrop and the .nfo file after filing. Your own TMDB and TheTVDB keys are optional. FileBot is a separate program with a paid licence. When FileBot files, Movie Agent still identifies each release first and picks its branch, then files what FileBot did not place.

Resolution

  1. Open Media library in the menu. While the library is off, the page shows The library is off. Switch it on in ….
  2. In the library settings, under the Organisers card, turn on Organise finished downloads into a media library. Press Review & save and confirm the changes in the window that opens.
  3. In the Organisers card, check that the Organises the finished downloads switch on the Movie Agent tile is on. It is on after the install, and the line under it reads on: Movie Agent names, files and fetches the artwork.

Tips

  • Only one of them files. With a licence, turning on the switch on the FileBot tile turns off the one on the Movie Agent tile. Without a licence FileBot files nothing, and the tile reads off: FileBot has no licence, so Movie Agent does the filing.
  • The FileBot guide shows how to install FileBot and activate its licence.

Rtorrent 16 guide: Media library · Rtorrent 16 guide: FileBot

How do I point Plex, Jellyfin or Kodi at the library?

Symptoms

  • You want Plex, Jellyfin or Kodi to show the films and series Rtorrent 16 downloads.
  • The media server does not see new downloads until you scan its library by hand.

Cause

Rtorrent 16 files finished films and series into the media library's folders, and the media server only reads them. By default the library is medialibrary/ in the base folder. Films go to the Movies folder and series to TV Shows. The 4K, Kids, Family, Anime and Adult branches have Movies and TV Shows folders of their own. The folders exist as soon as you save the settings, so you can point the server at them before the first file arrives.

Resolution

  1. On the Media library page, turn on Organise finished downloads into a media library. Press Review & save and confirm the changes in the window that opens.
  2. On the same page, read the library's path in the Media Library block of the Download routing card.
  3. In the media server, add a film library with every Movies folder and a series library with every TV Shows folder. The server must be able to see these folders.
  4. To have new files show up without a manual scan, open Settings → Media servers. For Plex, turn on Request a Plex library scan and fill in URL and token in the Plex server row. For Jellyfin, turn on Request an Emby/Jellyfin library scan and fill in URL and API key in the Emby / Jellyfin server row.
  5. For Kodi, turn on Request a Kodi library scan and type the address with Kodi's login in Kodi web server address, for example http://kodi:password@192.0.2.20:8080. Allow remote control via HTTP must be on in Kodi. Port 9090 does not work here.
  6. Press Review & save and confirm the changes in the window that opens.

Tips

  • On the volume of the downloads the library's files are hardlinks, so they take no extra space and the torrent keeps seeding.
  • In the Kids and Family branches, anime has one Anime folder for films and series together.
  • After filing a title, Movie Agent saves the poster and the backdrop (folder.jpg, fanart.jpg) and an .nfo file for Kodi, Jellyfin and Emby.
  • Kodi scans its own sources, so one of them has to cover the library folder.

Rtorrent 16 guide: Media library

I do not want the library. How do I keep files only in the downloads?

Symptoms

  • You want finished downloads to stay in the download folder, without the media library.
  • Finished downloads also show up in complete/ or in medialibrary/.

Cause

The media library is off until you switch it on. Apart from the library, the package puts each finished download in the completed folder, complete/ in the base folder unless you chose another. By default it does this as a hardlink: the same data under a second name, with no extra space on the same volume. On another volume it becomes a copy, which takes the space twice. With both off, a finished download stays only in the download folder.

Resolution

  1. Open Media library. off under the page title means the library is off and files nothing. If it reads on, turn off Organise finished downloads into a media library in the library settings under Organisers. Press Review & save and confirm the changes in the window that opens. New downloads are then not filed, and what is already in the library stays where it is.
  2. To stop the copies in the completed folder, open Settings → Files & storage and turn on Advanced at the top. Under Finished downloads, turn off Handle finished downloads. Press Review & save and confirm the changes.

Tips

  • With Handle finished downloads off, archives in a download are not unpacked by themselves. Unpack on the finished torrent's row unpacks them.
  • To keep only some downloads out of the completed folder, type their labels in Labels kept out of the completed folder. By default it holds seed,upload.

Rtorrent 16 guide: Media library

Add-ons3

Where do I find an add-on's first password?

Symptoms

  • You installed an add-on with its own login (Gopeed, autobrr, Soulseek, IRC or Linkwarden), and its page asks for a password you never set.

Cause

These add-ons create their own login during installation or first start, with a generated password. Each one writes the login to the QNAP System Logs and to first-run.txt in its var/log folder. If an add-on finds an existing account, it does not create another one.

Resolution

  1. Open the QNAP System Logs (Control Panel → System Logs) and look for the add-on's line:
    • Rtorrent 16 Gopeed: the line starts with Rtorrent 16 Gopeed first-run login:, user admin.
    • Rtorrent 16 autobrr: Rtorrent-autobrr:, user admin.
    • Soulseek (slskd): slskd:, user slskd.
    • IRC (soju + The Lounge): rtorrent16-irc:, user admin, one password for the web client and the bouncer.
    • Linkwarden: linkwarden:, user linkwarden.
  2. Or read the file over SSH, for example /usr/bin/Rtorrent16-Gopeed/var/log/first-run.txt. For the other add-ons, the folder is Rtorrent-autobrr, slskd, rtorrent16-irc or linkwarden.
  3. Gopeed and IRC also show the login in the panel. Gopeed: on the Add torrent page, press show next to Web login (admin) in the Browser integration card. IRC: the IRC page shows it under First-run login.
  4. Sign in and change the password in the add-on.

Tips

  • Search, FlareSolverr, Telegram and WhatsApp have no login of their own. They answer only on the NAS itself, and you use them through the panel.
  • Gopeed also accepts your Rtorrent 16 login or a NAS account.

Rtorrent 16 guide: Optional packages

I lost an add-on's password

Symptoms

  • You cannot sign in to an add-on with its own login: Gopeed, autobrr, Soulseek (slskd), IRC or Linkwarden.

Cause

Each of these add-ons keeps its own login. Gopeed lets you view its login in the panel; IRC lets you view or reset its login there. For the other add-ons, use SSH as described below.

Resolution

  1. Gopeed: on the Add torrent page, press show next to Web login (admin) in the Browser integration card. Your Rtorrent 16 login and a NAS account open Gopeed too, except an account with 2-step verification. For a new password and token, run /etc/init.d/rtorrent16-gopeed.sh reset-token; it writes them in the System Logs. Then enter the new token in the browser extension.
  2. autobrr: /usr/bin/Rtorrent-autobrr/bin/autobrrctl --config /usr/bin/Rtorrent-autobrr/etc change-password admin asks for the new password.
  3. Soulseek (slskd): change the password: line in the package's block at the end of /usr/bin/slskd/data/slskd.yml (keep the quotes), then run /etc/init.d/slskd.sh restart.
  4. IRC: press Reset the login on the panel's IRC page, or run /etc/init.d/irc.sh reset-login. It sets one new password for the web client and the bouncer, shows it under First-run login and writes it in the System Logs.
  5. Linkwarden: /etc/init.d/linkwarden.sh passwd makes a new password for the first account and writes it in the System Logs. /etc/init.d/linkwarden.sh passwd <user> <password> sets the password you choose.

Tips

The Rtorrent 16 panel's own password is separate from these. The Login and password guide shows how to set a new one.

Rtorrent 16 guide: Optional packages · Rtorrent 16 guide: Login and password

Do I have to enter my tracker account in Rtorrent 16?

Symptoms

  • You download from a private tracker and wonder whether Rtorrent 16 needs your login, password or API key for it.

Cause

Rtorrent 16 does not need the account to download or seed. A .torrent file from a private tracker carries your passkey in its tracker addresses, and rtorrent announces with those addresses. With an account on the Trackers page, the panel can search that tracker and fetch the .torrent files you pick from the results.

Resolution

  1. Download the .torrent file from the tracker's website while signed in to your account there.
  2. Add it to Rtorrent 16: press Add torrents in Quick access, or open the Add torrent page. rtorrent downloads and seeds with the addresses in the file.
  3. If you want to search the tracker from the panel, open Trackers, add the account under Accounts and save. The card is marked kept on this NAS, and a saved key is shown masked.

Tips

Keep a private .torrent file to yourself: its tracker addresses carry your passkey. A diagnostics dump of the package leaves tracker passkeys out.

Rtorrent 16 guide: Optional packages

LinkDrop3

Do I have to open a port on the router for LinkDrop?

Symptoms

  • You want to share files with LinkDrop and wonder whether the router needs setting up first.

Cause

No. The LinkDrop service connects the two ends, and the files go directly from one end to the other. With the default settings, the NAS asks the router for a way in by itself, over UPnP or NAT-PMP. When the router refuses, or a carrier's NAT sits in front of it, both ends open a direct path through their routers when a download starts (NAT punching).

Resolution

  1. In Files, right-click the file or folder and choose Share in the row at the top of the menu.
  2. Read the line at the bottom of the window: Connection: direct or Connection: through NAT punching. Both work without settings on the router.
  3. Pick Expires: and, if you want one, a Password:. Press Create link, then Copy and send the link.

Tips

  • The line appears after the first share, when this NAS registers with the LinkDrop service.
  • On some networks no direct path exists, for example when both ends sit behind routers that give every connection a port of its own (a VPN, many mobile networks). The download then ends with Failed: No direct path between these networks. Try another network, such as Wi-Fi in place of mobile data.

Rtorrent 16 guide: LinkDrop

Why can't I share the download folder with LinkDrop?

Symptoms

  • Sharing the download folder ends with Cannot share … as a whole (the download folder). Share what is inside it instead.
  • Sharing a folder that holds the download folder ends with Cannot share this folder: it holds … (…). Share something inside it instead.

Cause

LinkDrop does not share the folders Rtorrent 16 works in as a whole: the base folder, the download folder, the completed folder, the media library and the other folders torrents download to. You can share what is inside them: a torrent's folder or file, or an item of the library. LinkDrop does not share anything from Rtorrent 16's own folders: the package, rtorrent's session, backups, logs, settings and temporary files, the watch folder and the Trash folders. It also refuses a folder that holds any of these folders, as well as a whole share or volume.

Resolution

  1. Share a torrent from its row. In Quick access, right-click the torrent (on a phone, tap …) and choose Share via LinkDrop. The window shows the torrent's data path. Press Create link.
  2. Or open the download folder in Files, right-click the torrent's folder or file inside it and choose Share.

Tips

  • Share via LinkDrop makes a link only for a complete torrent. A torrent that is still downloading returns Download incomplete; no share created.
  • With several torrents selected, each gets its own link: press Create all links.

Rtorrent 16 guide: LinkDrop

Phone app1

Is there an app for the phone?

Symptoms

  • You want to use Rtorrent 16 on your phone, or send .torrent files and magnet links from the phone to the NAS.

Cause

Rtorrent 16 has its own app for Android and iPhone. The app opens this panel on the phone under the account used to pair it. It also sends .torrent files and magnet links from the phone to the NAS. The panel's Phone app page has the download and pairing. The Android app is on Google Play and needs Android 8.0 or newer. The iPhone app is in testing on Apple's TestFlight and needs iOS 16.

Resolution

  1. Android from Google Play: open Phone app and press Open in Google Play in the Rtorrent 16 on Google Play card. Install the app from Google Play on the phone.
  2. Android from the APK file: under Get the app, scan the QR code with the phone's camera, or press Download the APK on the phone itself. The page also shows the app's version, size and SHA-256. The Google Play version installs over the app from the APK and keeps the pairing.
  3. iPhone: in the iPhone app (testing) card, tap Join in TestFlight on the iPhone. The link opens once Apple approves the test version.
  4. Pair the phone. Connect it to the same network as the NAS and press Pair a phone under Pair. In the app, tap “Scan the QR code” and scan the code on the page.

Tips

  • Pairing works only on the home network and requires HTTPS. Enable HTTPS in Settings → Web access is on by default.
  • Away from home, the app reaches the NAS only with Remote access for the phone apps on. The Phone app guide has the steps.

Rtorrent 16 guide: Phone app

RSS, Radarr, Sonarr and search4

The RSS feed is added, but new episodes do not download

Symptoms

  • The feed is on the RSS page and refreshes, but its new episodes never reach the torrent list.
  • A rule is saved, and a matching item was still not added.

Cause

Rtorrent 16 adds an item from a feed only when it matches an enabled rule. A rule takes each episode and each film once: another release of the same episode, for example in another resolution, is skipped as a duplicate. An item is also not added when the folder written in the rule no longer exists.

Resolution

  1. On the RSS page, press Add rule. Under Match, keep Wildcards and type how the release name starts, for example Tulsa King S## (# stands for one digit).
  2. Read the line under Except. It says how many of the feed's items match and how many of them the rule adds when you save it. Below it are the feed's items, the matching ones on top. A matching item that the rule will not add shows why: Already added or Duplicate.
  3. Press Save rule. An enabled rule adds the matching items the feed lists at once, then each new one at every read of the feed.
  4. If still nothing happens, press Run now at the rule and read the Log at the bottom of the page. An added torrent has its own row with its state; a skipped item is one grey line with the reason.

Tips

  • A wildcard ignores letter case, and a space, dot, hyphen and underscore mean the same in it: Tulsa King matches Tulsa.King. To leave releases out, type for example 720p|CAM in Except.
  • A rule imported from ruTorrent takes only the items that appear after the import, until you save it again on the RSS page.

Rtorrent 16 guide: RSS

How do I connect Radarr and Sonarr to Rtorrent 16?

Symptoms

  • You want Radarr and Sonarr to add torrents to Rtorrent 16.
  • The download client test in Radarr or Sonarr fails.

Cause

Radarr and Sonarr see Rtorrent 16 as an rTorrent download client and connect to the panel's /RPC2 address. They sign in with a panel account, as you do when you sign in to the panel. The Connect another app card under Settings → Media servers shows the values to type in. The category you set in Radarr and Sonarr becomes the torrent's label.

Resolution

  1. Give the apps an account of their own. On the Security page, in the Accounts card, type a name such as arr and a password, then press Create account.
  2. Open Settings → Media servers and scroll to the Connect another app card.
  3. In Radarr, open Settings → Download Clients, press the + tile and pick rTorrent.
  4. Copy Host and Port from the card. In URL Path type RPC2, without a leading slash. In Username and Password type the name and password of the account from step 1. Tick Use SSL only when the card shows yes for Use SSL.
  5. In Category type radarr, then press Test and Save.
  6. Do the same in Sonarr, with the category sonarr.

Tips

  • The Connect another app card shows the address you opened Rtorrent 16 with in the browser, and the panel's own port. Opened over http, that is the HTTP port (6019 by default) and Use SSL: no. Opened over https, it is the HTTPS port (6018 by default) and yes. The How-to uses the HTTP port.
  • Keep the Let apps on other machines use /RPC2 (with login) switch under Settings → Web access on. It is on after the install. When you turn it off, /RPC2 answers only connections the NAS makes to itself.
  • In the media library the label radarr means a film and sonarr a series. The How-to covers the rest: a download folder for each label, Prowlarr, and turning off automatic import when Movie Agent files the downloads.

How-to: Radarr, Sonarr, Prowlarr and Seerr with Rtorrent 16

Can Radarr and Sonarr move the files instead of Movie Agent?

Yes. Movie Agent works only when the media library is enabled, and the library is disabled in a new installation. To keep using Movie Agent for other downloads, open Media library and add Radarr's and Sonarr's torrent labels to Labels ignored by Movie Agent and FileBot: radarr and sonarr in our guide, radarr4k and sonarr4k for the two 4K apps. Movie Agent then leaves those downloads alone, and Rtorrent 16 seeds them as usual. In Radarr and Sonarr, turn on Completed Download Handling and renaming (Rename Movies, Rename Episodes) so they import and name the files themselves. Rtorrent 16 leaves those entries in Radarr and Sonarr unchanged: it only updates them after Movie Agent has organised a title. Movie Agent's sorting into Kids, Family and 4K, its folder names in your language and its artwork do not apply to those titles.

How do I search trackers from the panel?

Symptoms

  • You want to search for torrents in the panel without opening the trackers' websites.
  • The Search page shows the Search add-on card with Not installed.

Cause

Searching trackers comes with a separate add-on, Rtorrent 16 Search, from the same App Center repository as Rtorrent 16. The add-on works only together with Rtorrent 16. It searches hundreds of public trackers at once, plus the trackers you have accounts on. The results appear on the Search page.

Resolution

  1. In App Center, open the QNAP Utilities repository and install Rtorrent 16 Search.
  2. Open the Trackers page. The Search add-on card shows whether the add-on is running, with its version and its sources.
  3. Press Sync sources now to make the add-on read its sources again.
  4. If you have an account on a private tracker, press Add a tracker account in the Accounts card, find the tracker by name and type the login once. Save and check tries it on the tracker at once.
  5. Search on the Search page. A click on a result shows its details, and Add on its row opens the form that adds the torrent.

Tips

  • Sources behind Cloudflare answer only through FlareSolverr. On a NAS with an Intel or AMD processor (x86_64), install Rtorrent 16 FlareSolverr from the same repository. On a NAS with an ARM processor (arm_64), run it in Container Station as the Search add-on card shows, with port 8191. The next sync finds it by itself.
  • Tracker logins stay in the add-on on this NAS. Removing the add-on deletes the tracker accounts; an update keeps them.
  • The All public sources switch in the Public sources card turns every public source off at once. Searches then use only your tracker accounts.

Rtorrent 16 guide: Optional packages

Notifications1

How do I get a notification on my phone when a download finishes?

Symptoms

  • You want a message on your phone when a torrent finishes, without looking at the panel.

Cause

Rtorrent 16 sends notifications to the destinations on the Notifications page, such as a chat in Telegram, WhatsApp, Discord or Signal. Each destination gets only the events picked under Send it. A phone paired with the Rtorrent 16 app needs no destination: it gets what you choose for it in the Paired phones card.

Resolution

  1. With the Rtorrent 16 app on your phone: open the Phone app page and press Pair a phone. Pairing works on the home network only. Then, on the Notifications page, check in the Paired phones card that Download finished is highlighted for that phone. A new phone has it on.
  2. Without the app: on the Notifications page, press Add in the Destinations card.
  3. Pick a service from Service, such as Telegram, Discord or Signal. Below the address, follow the steps under How to set up …. They say where each part of the address comes from.
  4. Under Send it, keep Download finished highlighted. A new destination has it picked from the start.
  5. Press Save, then Send test, and check that the message arrives.

Tips

  • WhatsApp pairs on the Notifications page itself, in the WhatsApp part at the top: press Get a pairing code and send the code to the bot from your phone with Open WhatsApp with the message. Once paired, Rtorrent 16 adds a WhatsApp destination by itself with Download finished picked.
  • A torrent labelled seed or upload sends no notification when it finishes.
  • The Sent messages card at the foot of the page lists every message that went out and each destination it failed to reach.

Rtorrent 16 guide: Notifications

Media studio and playback3

How do I make subtitles from a film's speech?

Symptoms

  • A film has no subtitles, and you want subtitles made from its dialogue.

Cause

Media studio recognises the speech of an audio track and makes a new subtitle track from it. Without an API key, the built-in Whisper engine does this on the NAS. On the first run, the NAS downloads the program and the speech recognition model and keeps both. The default model, large-v3-turbo, is 574 MB and needs about 1.1 GB of free memory. The small model is 190 MB and needs about 700 MB, but it makes more mistakes. On an ARM processor, or an Intel or AMD processor without AVX2, small is the default model.

Resolution

  1. In Files, open the menu of a video file and choose Media studio in the Tools group.
  2. Right-click the header of an audio track, for example A1, and choose Create subtitles from speech. On a phone, hold the header. The same button is in the Info panel while an audio clip is selected.
  3. Under Language, pick the language spoken in the film, or Detect automatically. While the model is not on the NAS yet, the window says This model is not on the NAS yet. It downloads the first time it is used (…). It needs about … of free memory.
  4. If the NAS has little free memory, open Advanced and pick Whisper small under Model. This choice is for this run only.
  5. Press Create. The status line shows the progress, and Stop ends the job. When the job ends, the project gets a new subtitle track, for example C1.
  6. The film itself does not change. Save as MKV writes a new film file with this track, and Export in the subtitle track's header menu writes the subtitles alone to a file of their own, for example an .srt.

Tips

  • Once you save an API key of an outside service in Media library → AI translation and speech, that service recognises the speech by default and receives the clip's audio. The window then says where the audio goes. To use the built-in engine for one run, pick Built-in (on the NAS) under Engine in Advanced. To use it every time, pick it on the same page under Speech recognition (speech → subtitles).
  • When the NAS has less free memory than the model needs, the job does not start and says how much it needs. Pick the small model, or stop other apps.
  • You can translate the new track: right-click its header and choose Translate subtitles.

Rtorrent 16 guide: Media studio

The subtitles are out of sync with the sound. How do I fix them?

Symptoms

  • The subtitles show a few seconds too early or too late through the whole film.
  • The subtitles match at the start of the film and drift further off with every minute.

Cause

Subtitles from another release of a film often have shifted times, or they were timed for another frame rate, for example 25 fps instead of 23.976 fps. Media studio compares where people speak with when the subtitles show, so the language of the subtitles does not matter. From that it works out the shift and the frame rate change, and it changes the subtitles only after you confirm.

Resolution

  1. In Files, open the menu of a video file and choose Media studio in the Tools group. To use subtitles from a separate file, press Import in the Sources panel and pick the file: it gets a new subtitle track.
  2. Right-click the header of the subtitle track, for example C1, and choose Sync subtitles to speech. On a phone, hold the header. While it analyses, the window says Analysing the speech in …: …%.
  3. Read the result: Audio track:, Frame rate: or Speed:, Shift: and Matching parts:. Press Apply. It moves every subtitle of the track, and Ctrl+Z puts them all back in one step.
  4. If the film already has another subtitle track with the right times, for example in another language, choose Match timing to … with that track's name, such as C2, in the same menu, and press Apply.
  5. When the window says the subtitles do not match, set them by hand. Click a clip of the subtitle track to open the cue list. On its toolbar, Shift subtitles moves every subtitle by the time you type: type it under Shift by, for example 1.5, and press Earlier or Later. Sync points sets where two subtitles start and moves the others in proportion.
  6. The film itself does not change. Save as MKV writes a new film file with the corrected subtitles, and Export in the subtitle track's header menu writes the subtitles alone to a file of their own.

Tips

  • Sync subtitles to speech looks for a shift of up to a minute either way. It changes nothing when the track has fewer than 20 subtitles or covers less than a minute of the film, when the film has too little dialogue, or when the subtitles do not match the speech. The window then says why. Subtitles for a cut of the film with scenes added or removed can match nowhere as a whole. Set them with Sync points then.
  • Sync the subtitles before you cut the film: the sync needs the video on the timeline in one clip, and a subtitle track from a file also in one clip.

Rtorrent 16 guide: Media studio

How do I watch a downloaded film in the browser or on the TV?

Symptoms

  • You want to watch a downloaded film without copying it to a computer first.
  • You want to watch it on the TV.

Cause

Quick access plays a torrent's video and music in the browser, on a phone as on a computer. Play appears on a torrent's row once part of it is downloaded, and a file plays once it is complete. The package does not convert the picture. When the browser has no decoder for the sound (AC3, EAC3, DTS, TrueHD), the package's ffmpeg turns only the sound into AAC while the film plays. The cast button in the player sends only music to a device on the network. A film reaches the TV through a media server or a player such as Plex, Jellyfin or Kodi.

Resolution

  1. On Quick access, press Play on the torrent's row. On a phone, open the row first: its buttons are under it.
  2. Click the picture, or press Full screen, to watch over the whole screen. There you choose the file under Files, the sound under Audio and the Subtitles. Press Escape or Back to the bar to return to the bar without stopping the film.
  3. Press Stop to end it.
  4. For the TV, switch on the media library, point Plex, Jellyfin or Kodi at its folders, and play the film in its app on the TV.

Tips

  • The player says when the browser cannot decode the picture, for example HEVC in Chrome without a hardware decoder (Safari plays it), AV1 in an older Safari, or Dolby Vision profile 5. For Dolby Vision profile 5 it advises a TV app or a player on the NAS.
  • Text subtitles come from the film's own tracks and from subtitle files beside it with a language tag, such as film.pl.srt. Picture subtitles (PGS, DVD) do not show in the browser.

Rtorrent 16 guide: Playing and previewing files · Rtorrent 16 guide: Media library

When something goes wrong3

Rtorrent 16 stopped or does not start. How do I find out why?

Symptoms

  • Torrents stopped, and the Dashboard shows rtorrent stopped.
  • rtorrent does not start, or it stops again after a while.

Cause

The package keeps a journal of every start, stop, restart and crash of rtorrent, with who asked for it and why. The watchdog checks every 5 minutes. When it finds rtorrent dead although it should run, it records the reason, starts rtorrent again and sends a notification. The reason is the kernel's out-of-memory killer or the last line of rtorrent's log. When rtorrent does not start, the journal says why, for example that another rtorrent uses the session folder.

Resolution

  1. Open the Dashboard and read the rtorrent badge at the start of the state strip. While rtorrent is down, it reads rtorrent stopped · …, … with who stopped it and when. For a day after a crash, a line above the strip reads rtorrent crashed …: … with the reason.
  2. Read the Activity card further down the page. Each line has the time, the engine, what happened and who did it. Show more lists more lines. The lines are in English in every language of the panel; a crash reads "rtorrent exited on its own" with the reason.
  3. Make a diagnostic dump. Press Diagnostic dump at the top of Diagnostics, or the same link in the crash line on the Dashboard. Keep Not about a specific torrent and press Create dump. The window lists the files in the dump and what was taken out of them: passwords, keys, tokens and tracker passkeys go, and the torrents become numbers such as [torrent-3].
  4. Press Download (…) and send the file to whoever helps you. The window can also prepare a forum post with a link to the dump: under Ask for help on the forum, press Create LinkDrop link, write what happens in the first line of Post for the forum and press Copy post. Then press Open the Rtorrent 16 thread and paste the post as a reply.

Tips

  • Before you post, read the pinned thread "Rtorrent16: How to report ANY issues and software status" in the forum's Rtorrent 16 section.
  • When the panel does not open, make the dump over SSH with /etc/init.d/rtorrent16.sh diag. Its "file" line is the path of the dump.
  • When the reason names the out-of-memory killer, lower Max memory for pieces (MiB) in Settings → Bandwidth & limits.

Rtorrent 16 guide: Control Center

The NAS's disks never sleep while Rtorrent 16 runs

Symptoms

  • The NAS's disks never go to standby while Rtorrent 16 runs, even when nothing downloads.
  • You hear the disks every few minutes, also at night.

Cause

Rtorrent 16 uses the disks even when nothing downloads. The watchdog writes a few log lines every five minutes, and rtorrent saves its session every 15 minutes. A seeding torrent reads from the disk each piece a peer asks for. By default the logs and the session are kept with the package, on the volume where Rtorrent 16 is installed. When that volume is on the spinning disks, those disks get a write at least every five minutes.

Resolution

  1. Open Settings → Files & storage and check Where logs, settings and temporary files are kept and Where rtorrent keeps its session. With the package means the volume where Rtorrent 16 is installed.
  2. If that volume is on the spinning disks and the NAS has an SSD volume, move the files there, one setting at a time. Pick A directory I choose in Where logs, settings and temporary files are kept and choose a folder on the SSD volume in Folder for logs, settings and temporary files. Press Review & save and confirm the move. Then do the same with Where rtorrent keeps its session and Session directory. rtorrent stops while the files move and starts again.
  3. Stop the reading at night. Open Settings → Date & time, turn on Night mode, pick Pause every torrent as the Night action, set Night mode starts at and Night mode ends at, and save. At night rtorrent neither downloads nor seeds, and the daily copies, the media library's 04:00 pass, the seeding rules and the Trash wait for the morning.

Tips

  • Night mode does not stop the log writes. The data disks rest at night only when the logs and the session are on other disks (step 2).
  • Only Pause every torrent stops downloads and seeding at night. With Lowest upload, downloads go on, torrents keep downloading at night, and the daily copies and the media library run as in the day.
  • In the base folder puts the session on the data volume of the downloads.

Rtorrent 16 guide: Control Center

Where do I ask for help?

Ask on forum.qnap.net.pl, in English or in Polish. Before you ask, read the difference between torrenting on a PC and on a NAS. The guides are in the panel.

See how Rtorrent 16 compares

qBittorrent, Transmission, Deluge, aria2 and other NAS download apps, feature by feature.