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/ |
| Tag | Description | Best For |
|---|---|---|
latest / pkg |
FreeBSD Quarterly. Uses stable, tested packages. | Most users — recommended. |
pkg-latest |
FreeBSD Latest. Rolling package updates. | Staying current. |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.
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= # Web UI Username
- PASS=<PASS> # 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"
# always (not unless-stopped) so FreeBSD's podman rc.d auto-starts it at boot
restart: alwaysSave as compose.yaml, then run podman-compose up -d.
.env:
# .env
DIRECTOR_PROJECT=transmission
PUID=1000
PGID=1000
TZ=UTC
USER=
PASS=<PASS>
appjail-director.yml:
# appjail-director.yml
options:
- virtualnet: ':<random> default'
- nat:
services:
transmission:
name: transmission
options:
- container: '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
- downloads: /downloads
- transmission_watch: /watch
volumes:
transmission:
device: '/path/to/containers/transmission'
downloads:
device: 'downloads'
transmission_watch:
device: '/path/to/containers/transmission/watch'Makejail:
# Makejail
ARG tag=latest
OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/transmission:${tag}
Save the files above, then run appjail-director up.
Warning
Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.
To avoid exposing ports, just remove the expose option in your appjail-director.yml or from your command-line arguments.
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:latestSave as run.sh, then run sh run.sh.
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 transmissionSave the files above, then run sh run.sh.
Warning
Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.
To avoid exposing ports, just remove the expose option in your appjail-director.yml or from your command-line arguments.
Warning
Bastille's OCI support is experimental. It requires buildah and shares the host network stack (inherit). Mount volumes with --volume HOST JAIL; without it, image-declared volumes are stored under ${bastille_volumesdir}/${jail}.
services:
transmission:
name: transmission
image: "ghcr.io/daemonless/transmission:latest"
network:
- mode: host
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"Save as bastille-compose.yml, then run bastille up. Or via CLI:
bastille create -O \
--env PUID=1000 \
--env PGID=1000 \
--env TZ=UTC \
--env USER= \
--env PASS=<PASS> \
--volume /path/to/containers/transmission /config \
--volume /path/to/downloads /downloads \
--volume /path/to/containers/transmission/watch /watch \
transmission ghcr.io/daemonless/transmission:latest inherit- 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"Save as transmission-deploy.yaml, then run ansible-playbook transmission-deploy.yaml.
| 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 |
`` | Web UI Username |
PASS |
<PASS> |
Web UI Password |
| Path | Description |
|---|---|
/config |
Configuration directory |
/downloads |
Download directory |
/watch |
Watch directory for .torrent files |
| Port | Protocol | Description |
|---|---|---|
9091 |
TCP | Web UI |
51413 |
TCP | Torrent peer port |
51413 |
UDP | Torrent peer port |
Architectures: amd64, aarch64
User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000)
Base: FreeBSD 15.1
Need help? Join our Discord community.