Skip to content

Transmission Transmission

Description / nameInput element
Container Registry
Container Configuration Root Path
Global /downloads Path
Timezone
User ID
Group ID
Transmission Host Port
Transmission /config Path
Transmission /watch Path

Build Status Last Commit

Lightweight BitTorrent client with a web UI for managing torrent downloads.
Port 9091
Registry ghcr.io/daemonless/transmission
Daemonless daemonless/transmission
Source transmission/transmission
Website transmissionbt.com

Version Tags

Tag Description Best For
latest / pkg FreeBSD Quarterly. Uses stable, tested packages. Most users — recommended.
pkg-latest FreeBSD Latest. Rolling package updates. Staying current.
Tag Description Best For
latest-aarch64 / pkg-aarch64 FreeBSD Quarterly. Uses stable, tested packages. Most users — recommended.
pkg-latest-aarch64 FreeBSD Latest. Rolling package updates. Staying current.

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.

Deployment

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
services:
  transmission:
    image: "ghcr.io/daemonless/transmission:latest"
    container_name: transmission
    environment:
      - PUID=1000  # User ID for the application process
      - PGID=1000  # Group ID for the application process
      - TZ=UTC  # Timezone for the container
      - USER=  # Optional: Web UI Username
      - PASS=<PASS>  # Optional: Web UI Password
    volumes:
      - "/path/to/containers/transmission:/config"
      - "/path/to/downloads:/downloads"
      - "/path/to/containers/transmission/watch:/watch"
    ports:
      - "9091:9091"
      - "51413:51413"
      - "51413:51413"
    restart: unless-stopped

1
2
3
4
5
6
7
8
# .env

DIRECTOR_PROJECT=transmission
PUID=1000
PGID=1000
TZ=UTC
USER=
PASS=<PASS>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  transmission:
    name: transmission
    options:
      - container: 'boot args:--pull'
      - expose: '9091:9091 proto:tcp'
      - expose: '51413:51413 proto:tcp'
      - expose: '51413:51413 proto:udp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - USER: !ENV '${USER}'
        - PASS: !ENV '${PASS}'
    volumes:
      - TRANSMISSION_CONFIG_PATH: /config
      - DOWNLOADS_PATH: /downloads
      - TRANSMISSION_WATCH_PATH: /watch
volumes:
  TRANSMISSION_CONFIG_PATH:
    device: '/path/to/containers/transmission'
  DOWNLOADS_PATH:
    device: '/path/to/downloads'
  TRANSMISSION_WATCH_PATH:
    device: '/path/to/containers/transmission/watch'

1
2
3
4
5
6
# Makejail

ARG tag=latest

OPTION overwrite=force
OPTION from=ghcr.io/daemonless/transmission:${tag}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
podman run -d --name transmission \
  -p 9091:9091 \
  -p 51413:51413 \
  -p 51413:51413 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e USER= \
  -e PASS=<PASS> \
  -v /path/to/containers/transmission:/config \
  -v /path/to/downloads:/downloads \
  -v /path/to/containers/transmission/watch:/watch \
  ghcr.io/daemonless/transmission:latest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
appjail oci run -Pd \
  -o overwrite=force \
  -o container="args:--pull" \
  -o virtualnet=":<random> default" \
  -o nat \
  -o expose="9091:9091 proto:tcp" \
  -o expose="51413:51413 proto:tcp" \
  -o expose="51413:51413 proto:udp" \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e USER= \
  -e PASS=<PASS> \
  -o fstab="/path/to/containers/transmission /config <pseudofs>" \
  -o fstab="/path/to/downloads /downloads <pseudofs>" \
  -o fstab="/path/to/containers/transmission/watch /watch <pseudofs>" \
  ghcr.io/daemonless/transmission:latest transmission

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
- name: Deploy transmission
  containers.podman.podman_container:
    name: transmission
    image: "ghcr.io/daemonless/transmission:latest"
    state: started
    restart_policy: always
    env:
      PUID: "1000"
      PGID: "1000"
      TZ: "UTC"
      USER: ""
      PASS: "<PASS>"
    ports:
      - "9091:9091"
      - "51413:51413"
      - "51413:51413"
    volumes:
      - "/path/to/containers/transmission:/config"
      - "/path/to/downloads:/downloads"
      - "/path/to/containers/transmission/watch:/watch"

Interactive Configuration

Parameters

Environment Variables

Variable Default Description
PUID 1000 User ID for the application process
PGID 1000 Group ID for the application process
TZ UTC Timezone for the container
USER `` Optional: Web UI Username
PASS <PASS> Optional: Web UI Password

Volumes

Path Description
/config Configuration directory
/downloads Download directory
/watch Watch directory for .torrent files

Ports

Port Protocol Description
9091 TCP Web UI
51413 TCP Torrent peer port
51413 UDP Torrent peer port

Implementation Details

  • Architectures: amd64, aarch64
  • User: bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
  • Base: Built on ghcr.io/daemonless/base (FreeBSD 15.1).

Need help? Join our Discord community.