Transmission¶

Transmission is a BitTorrent client.

There is no official image for this service, so we'll use ghcr.io/linuxserver/transmission.

Pre-Installation¶

We'll create a folder in the main user's home where all the service's data will be saved.

mkdir ~/services/downloads/transmission

We'll need to download a GUI for Transmission manually. For this, inside the newly created folder, run the following commands:

curl -OL https://github.com/johman10/flood-for-transmission/releases/download/latest/flood-for-transmission.zip
unzip flood-for-transmission.zip && rm flood-for-transmission.zip
mv flood-for-transmission web-ui

External Network¶

Since this service needs to interoperate with another one, we'll need to have them inside the same network. Make sure to have created the downloads_external network before defining the docker-compose.yml file. If you haven't created this network, you can do so with:

docker network create downloads_external

Docker Compose¶

Transmission will be run using Docker Compose. The content of the docker-compose.yml file is as follows:

services:
  web:
    image: ghcr.io/linuxserver/transmission:latest
    restart: unless-stopped
    networks:
      default:
      downloads_external:
      proxy_external:
        aliases:
          - transmission
    ports:
      - 51413:51413
      - 51413:51413/udp
    volumes:
      - ./config:/config
      - ./watch:/watch
      - ./web-ui:/flood-for-transmission
      - /media/sata_2tb/Downloads:/downloads
    environment:
      TZ: America/Guayaquil
      TRANSMISSION_WEB_HOME: /flood-for-transmission/
      USER: BASIC_AUTH_USER
      PASS: BASIC_AUTH_PASSWORD
      PUID: 1000
      PGID: 1000
    labels:
      traefik.enable: true
      traefik.docker.network: proxy_external
      traefik.http.routers.transmission.rule: Host(`transmission.alpha.example.com`) || Host(`transmission.alpha.home.example.com`)
      traefik.http.routers.transmission.entrypoints: local-https
      traefik.http.routers.transmission.tls: true
      traefik.http.routers.transmission.tls.certresolver: le
      traefik.http.routers.transmission.service: transmission@docker
      traefik.http.services.transmission.loadbalancer.server.port: 9091

networks:
  downloads_external:
    external: true
  proxy_external:
    external: true

Note

In the case of the PUID and PGID environment variables, 1000 corresponds to the user's UID and GID respectively. You can find the values for your own user by running id $whoami.

Note

Make sure to replace BASIC_AUTH_USER and BASIC_AUTH_PASSWORD to something secret of your own choosing.

Note

You may change the contents of transmission-config/settings.json as long as the container is stopped.

Reverse Proxy¶

This service is exposed by a reverse proxy. More specifically, it is using Traefik.

For this reason, you will see that this service has:

A directive to connect it to the proxy_external external network.
A container alias for the proxy_external network.
A number of labels with names starting with traefik.

If you're not using a reverse proxy, feel free to remove these from the docker-compose.yml file. Keep in mind you might need to bind the ports to connect to the service instead.

Running¶

Start up the service with:

docker compose up -d

That's it! The service will auto-start on system startup and restart on failure.