How to Set Up Transmission with Docker Compose (Video, With or Without a VPN)

Transmission logo with the words install with Docker Compose, with or without a VPN

For educational purposes only. This guide shows how to install self-hosted software on your own hardware. I don't condone piracy: only use these apps with media you own or have the right to use, and follow the law where you live. Back up your data first. Full disclaimer

Updated 16 November 2026 Tested with: Transmission 4.1.4

Transmission is a small, free torrent client that’s been around for about 20 years. It uses very little memory, has a clean web page you can open from any device, and can slow itself down while the family is streaming. Running it in Docker means it lives on your server and downloads around the clock.

This guide sets up Transmission with Docker Compose in five short steps, either on its own or behind a VPN with Gluetun. It takes about 15 minutes.

Transmission or qBittorrent? Both work well with Radarr and Sonarr. Transmission is lighter and simpler, with fewer settings to get wrong. qBittorrent has more features, like categories with their own folders and a built-in search. If you just want something that downloads quietly, pick Transmission.
On this page (13 sections)

Watch: install Transmission with Docker Compose

The video has subtitles at the bottom and no sound. It uses the simplest setup, one downloads folder and no VPN, recorded on a clean test install. The generator and steps below make the same thing, plus the optional Gluetun VPN and the /data folder layout that Radarr and Sonarr need.

See Turtle Mode and seeding limits in action

Press Play the day to watch a big download from 6 pm to 6 pm the next day. Then tick Turtle Mode and play it again. Under the demo is the generator you’ll use in Step 1.

Open the generator full screen

What you need to set up Transmission with Docker Compose

  • A computer or NAS running Docker. New to Docker? The Docker install guide covers Windows, Mac and Linux.
  • Somewhere with space for downloads.
  • Optional: a VPN subscription, if you want to run it through Gluetun.

Use it legally. Transmission is a download tool. What you download with it is up to you. Only download files you have the right to, such as Linux installers, open-source software and public-domain media. Downloading copyrighted material without permission is illegal in the UK and most other countries.

With or without a VPN? Without one, everyone sharing a torrent with you can see your home IP address. If you’d rather keep your IP address private, choose the With Gluetun option. The generator adds Gluetun to the same file for you, and the Gluetun guide shows where to find your VPN key.

Step 1: Make your compose file

In the generator, choose With Gluetun or Without a VPN, fill in your details, and then on your server:

  1. Make a folder and go into it:
    mkdir -p ~/transmission && cd ~/transmission
  2. Save the generator’s compose.yaml there. Use the Download button, or run nano compose.yaml, paste, then press Ctrl+O, Enter and Ctrl+X.
  3. Do the same for .env. Put a password after TRANSMISSION_PASS=, using letters and numbers only. With Gluetun, also paste your VPN key after WIREGUARD_PRIVATE_KEY=.
  4. With ProtonVPN or PIA, there’s also a port-up.sh tab. Save it where the tab says.

PUID and PGID are the user Transmission runs as, so its files belong to you. Type id on your server and use the uid and gid numbers.

What’s port-up.sh for? ProtonVPN and PIA give you a port that other peers can connect to, which makes torrents faster. It changes now and then, so Gluetun runs this little script each time to tell Transmission the new number. I tested it against a real Transmission 4.1.

Step 2: Start it and sign in

Run the commands from the generator’s Commands tab. They create the folders, give them to your user, and start everything. With Gluetun, give it about 30 seconds to connect.

Open http://YOUR-SERVER-IP:9091 and sign in with the TRANSMISSION_USER and TRANSMISSION_PASS from your .env. Unlike qBittorrent, there’s no temporary password to look up.

Step 3: Tell it where to save, and when to stop seeding

Click the ☰ menu (top right) and choose Edit preferences. On the Torrents tab:

  1. Set Download to to /data/torrents/complete.
  2. Tick Use temporary folder and set it to /data/torrents/incomplete. Half-finished files stay out of the way until they’re done.
  3. Tick Stop seeding at ratio and leave it on 2. Each torrent then uploads twice what it downloaded, and stops by itself.

Transmission saves each change straight away. There’s no Save button.

Transmission preferences Torrents tab: download to /data/torrents/complete, temporary folder /data/torrents/incomplete, stop seeding at ratio 2
Edit preferences → Torrents.

/data/torrents is the folder inside the container. The generator connected it to the data folder on your server, so finished downloads appear there.

Step 4: Turn on Turtle Mode

Turtle Mode is Transmission’s best trick: a second, slower speed limit that switches on by itself at set times. Open the Speed tab:

  1. Under Alternative Speed Limits, set Upload and Download. For example 500 and 2000 kB/s, which leaves plenty for streaming.
  2. Tick Scheduled times and pick when people are home, like 8:00 to 23:00.
Transmission preferences Speed tab with Alternative Speed Limits 500 up and 2000 down, scheduled from 8:00 to 23:00 every day
Edit preferences → Speed: slow from 8:00 to 23:00, full speed overnight.

When it’s on, the turtle button at the top right turns blue. You can also click it to switch Turtle Mode on or off by hand.

Step 5: Test it with a real torrent

A free Linux installer is a good, legal test. The video uses Debian’s, and the screenshots below use Ubuntu’s:

  1. Copy the link to Debian’s netinst.iso.torrent from cdimage.debian.org, or to the latest Ubuntu Desktop torrent from ubuntu.com/download/alternative-downloads.
  2. In Transmission, click Open, paste it under Or enter a URL and click Add.
Transmission Add Torrents dialog with the Ubuntu desktop torrent URL and destination folder /data/torrents/complete
Open → paste the link → Add.

It should start within a few seconds. Here it’s held at 2 MB/s, because Turtle Mode was on:

Transmission downloading the Ubuntu 24.04.4 desktop ISO from 48 of 50 peers at 2.01 MB/s with the turtle button switched on
48 peers, and the speed held at exactly the Turtle Mode limit.

With Gluetun, also check two things. First, that Transmission is using the VPN. This should show the VPN’s IP, not your home’s:

docker exec transmission curl -s https://ipinfo.io/ip

Second, with ProtonVPN or PIA, that the script handed over the port. You should see a “port forwarded” line and a “peer port set to” line with the same number:

docker logs gluetun 2>&1 | grep -iE "port forwarded|peer port set"

In Transmission, Edit preferences → Network then shows the same number as the Peer listening port, and Port is Open. That’s it, Transmission is up and running. 🎉

Optional: connect Radarr and Sonarr

In Radarr, go to Settings → Download Clients, click + and choose Transmission. Enter your server IP, port 9091, and your Transmission username and password. Leave URL Base as /transmission/ and Category as radarr, then click Test and Save. Do the same in Sonarr. The generator’s Connect tab has these values filled in for you.

Optional: a nicer web page

Transmission’s own web page is plain but works fine. If you’d like something more modern, the image can swap it for one of these. I tried both:

  • TrguiNG: looks like a desktop app, with labels, a files and peers panel, and a dark mode. My pick.
  • Flood for Transmission: clean and simple, and good on a phone.

Add one line under environment: in your compose file and run docker compose up -d:

      - DOCKER_MODS=linuxserver/mods:transmission-trguing

For Flood, use linuxserver/mods:transmission-floodui instead. To go back, delete the line and run docker compose up -d again.

TrguiNG web interface for Transmission with status filters, torrent list and details panel
TrguiNG.
Flood for Transmission web interface with download and upload speeds, status filters and torrent list
Flood for Transmission.

On an Android phone, Tremotesf connects to the same address with the same login.

If something’s wrong

  • The web page won’t open. Check the containers are running with docker compose ps. With Gluetun, the port has to be under gluetun’s ports: (the generator does this), and Gluetun must be healthy.
  • It keeps asking for a password. Use the TRANSMISSION_USER and TRANSMISSION_PASS from .env. If the password has symbols like $ or &, change it to letters and numbers and run docker compose up -d.
  • Downloads say “Permission denied”. The data folder doesn’t belong to your PUID/PGID. Run the chown line from the Commands tab again.
  • The listening port doesn’t match Gluetun’s. Check port-up.sh is in the scripts folder and executable (chmod +x), and look for “Transmission did not answer” in docker logs gluetun. That means the user or password in .env is wrong.
  • Network says “Port is Closed”. Downloads still work, just slower. Without a VPN, forward port 51413 (TCP and UDP) on your router. With a VPN, choose one with port forwarding, such as ProtonVPN Plus, PIA or AirVPN.
  • Downloads are slow during the day. That’s Turtle Mode doing its job. Click the turtle button to switch it off for now.

Updating Transmission

cd ~/transmission
docker compose pull && docker compose up -d

Your settings and downloads are kept, because they live in the config and data folders, not in the container.

🧰 What I use

Proton VPN desktop app connected to Switzerland, with P2P servers and the Port forwarding button

Proton VPN: works with Gluetun over WireGuard. Its port forwarding gives you an open port, so you can make more connections.

Get Proton VPN

This is an affiliate link: if you sign up through it, I may earn a commission, at no extra cost to you. Use a VPN for privacy, and only download what you have the right to.

Frequently asked questions

Is Transmission or qBittorrent better for Radarr and Sonarr?

Both work well. Transmission is lighter and simpler; qBittorrent has more features such as categories with their own folders and a built-in search.

What is Turtle Mode in Transmission?

A second, lower speed limit that can switch on by itself at set times, so downloads do not slow down everyone else's internet in the evening.

How do I set the Transmission password in Docker?

The LinuxServer image reads USER and PASS from the environment. The generator puts them in .env as TRANSMISSION_USER and TRANSMISSION_PASS; use letters and numbers only.

Does Transmission work with Gluetun port forwarding?

Yes. With ProtonVPN or PIA, Gluetun runs a small port-up.sh script that tells Transmission the forwarded port each time it changes. Leave PEERPORT out, or it resets the port on every restart.

Thank you

Transmission is free and open source, made by volunteers at transmissionbt.com. Thanks also to LinuxServer.io for the Docker image and the web page mods, and to the TrguiNG and Flood for Transmission developers.

Related guides: qBittorrent · Gluetun · Radarr · Sonarr · Complete Arr Stack

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.

Leave a Reply