transmission

About

Transmission is a fast, easy, and free BitTorrent client.

• Github
• website
• Docker Image

Table of Contents

• About
• Table of Contents
• Information
  • docker-compose
• Usage
  • Requirements
  • Configuration
• Update
• Backup

.
|-- .env
|-- data/
`-- docker-compose.yml

• .env - a file containing all the environment variables used in the docker-compose.yml
• docker-compose.yml - a docker-compose file, use to configure your application’s services
• data/ - a directory used to store the data

Please make sure that all the files and directories are present.

Information

docker-compose

Links to the following docker-compose.yml and the corresponding .env.

• docker-compose.yml

  vversion: '3'
  
  services:
  transmission:
      image: 'linuxserver/transmission:latest'
      container_name: transmission
      restart: unless-stopped
      volumes:
        - ./data/config:/config
        - ./data/downloads:/downloads
        - ./data/watch:/watch
      environment:
        - PUID=${PUID}
        - PGID=${PGID}
        - TZ=${TZ}
        - USER=${WEB_USER}
        - PASS=${WEB_PASS}
      ports:
        - 51413:51413
        - 51413:51413/udp
      networks:
        - proxy
      labels:
        - "traefik.enable=true"
        - "traefik.http.routers.transmission.rule=Host(`${TRAEFIK_TRANSMISSION}`)"
        - "traefik.http.routers.transmission.entrypoints=https"
        - "traefik.http.routers.transmission.tls=true"
        - "traefik.http.routers.transmission.tls.certresolver=mydnschallenge"
        - "traefik.http.services.transmission.loadbalancer.server.port=9091"
        # Watchtower Update
        - "com.centurylinklabs.watchtower.enable=true"
  
  networks:
    proxy:
      external: true

• .env

  TRAEFIK_TRANSMISSION=transmission.example.com
  TZ=Europe/Paris
  WEB_USER=xxxxxxxxxxxxxxx
  WEB_PASS=xxxxxxxxxxxxxxx
  
  # user PUID and group PGID - can be found by running id your-user
  PUID=1000
  PGID=1000
  

The docker-compose contains only one service using the transmission image.

Usage

Requirements

• Traefik up and running.
• A subdomain of your choice, this example uses transmission.
  • You should be able to create a subdomain with your DNS provider, use a A record with the same IP address as your root domain.
• Port 51413 open, check your firewall.

Configuration

The linuxserver images are using the PUID and PGID, they allow the container to map the container's internal user to a user on the host machine, more information here.

To find yours, use id user. Replace the environment variables in .env with your own, then run :

sudo docker-compose up -d

Update

The image is automatically updated with watchtower thanks to the following label :

  # Watchtower Update
  - "com.centurylinklabs.watchtower.enable=true"

Backup

Docker volumes are globally backed up using borg-backup.

You may want to exclude the downloads folder from the backups, add the following to borg-backup/excludes.txt:

/full/path/to/transmission/data/downloads