Transmission

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

Lightweight BitTorrent client with a web UI for managing torrent downloads.


Port	9091
Registry	`ghcr.io/daemonless/transmission`
Source	https://github.com/transmission/transmission
Website	https://transmissionbt.com/

Version Tags

Tag	Description	Best For
`latest` / `pkg`	FreeBSD Quarterly. Uses stable, tested packages.	Most users. Matches Linux Docker behavior.
`pkg-latest`	FreeBSD Latest. Rolling package updates.	Newest FreeBSD packages.

Root Privileges Required

Podman on FreeBSD currently requires root. All commands must be run as root (or via doas/sudo).

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

Podman Compose AppJail Director Podman CLI Ansible

services:
  transmission:
    image: ghcr.io/daemonless/transmission:latest
    container_name: transmission
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - USER=
      - PASS=<PASS>
    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

.env:

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

appjail-director.yml:

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  transmission:
    name: transmission
    options:
      - container: 'boot args:--pull'
    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'

Makejail:

ARG tag=latest

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

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

- 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"

Access at: http://localhost:9091

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
User: bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
Base: Built on ghcr.io/daemonless/base (FreeBSD 15.0).

Need help? Join our Discord community.