atix0/transmission

By atix0

•Updated 3 months ago

Transmission server for ARMv7.

Image

Web servers

2.4K

Overview Tags

atix0/transmission repository overview

⁠Transmission ARMv7 Docker Image

A lightweight, headless BitTorrent client based on Alpine Linux, pre-configured with the enhanced Transmission Web Control⁠ interface.

Originally created to provide an up-to-date Transmission client specifically for ARMv7 devices, but works on standard x86_64 systems as well.

⁠Features

Base: Alpine Linux (Latest)
Core: Transmission Daemon 4.0.x
UI: Transmission Web Control (default)
Arch: Multi-platform support (linux/arm/v7, linux/amd64)

⁠Quick Start (Docker Compose)

Here is a ready-to-use docker-compose.yml example.

services:
  transmission:
    image: atix0/transmission:latest
    container_name: transmission
    restart: unless-stopped
    environment:
      - TZ=Europe/Budapest
      - RPC_USERNAME=admin
      - RPC_PASSWORD=secretpassword
      - DOWNLOAD_DIR=/downloads
    volumes:
      - ./config:/transmission/config
      - ./media:/downloads
    ports:
      - "9091:9091"
      - "24661:24661"
      - "24661:24661/udp"

⁠Configuration & Behavior

This image utilizes a "bootstrap" configuration logic for settings.json.

⁠1. First Run (Initialization)

When the container starts for the first time, it checks for /transmission/config/settings.json. If missing, it generates a new one based on the Environment Variables below.

⁠2. Subsequent Runs (Persistence)

If settings.json already exists, the container ignores Environment Variables and strictly uses the existing file.

⚠️ Important: Changing ENV variables in Docker Compose after the initial run will have no effect. To apply new ENVs, you must delete settings.json and restart the container to force regeneration, or edit the JSON file manually.

⁠Environment Variables

Variable	Default	Description
`RPC_USERNAME`	`transmission`	Username for the Web Interface.
`RPC_PASSWORD`	(none)	Password for the Web Interface.
`DOWNLOAD_DIR`	`/media`	The internal path where torrents are saved.
`TZ`	`UTC`	System timezone (e.g., `Europe/Budapest`).

⁠Directories & Ports

⁠Volumes

Container Path	Description
`/transmission/config`	Stores `settings.json`, resume data, and .torrent files.
`/downloads`	Default path for completed downloads (adjustable via `DOWNLOAD_DIR`).

⁠Ports

Port	Protocol	Description
`9091`	TCP	Web Interface (Access via `http://IP:9091`)
`24661`	TCP/UDP	BitTorrent incoming connections (Peer port)

⁠Version History

2026.07.02: Update Transmission to 4.1.3.
2026.02.27: Update Transmission to 4.1.1.
2025.12.04: Update Transmission to 4.1.0.
2025.12.04: Update Alpine to 3.23 & add ENV support.
2025.08.29: Update Alpine to 3.22.1.
2025.06.12: Update Alpine to 3.22.0.
2025.01.09: Update Alpine to 3.21.2.
2024.12.12: Update Alpine to 3.21.
2024.10.22: Initial Release.

Tag summary

Recent tags

Content type

Image

Digest

sha256:7a4cb34a7…

Size

12.9 MB

Last updated

3 months ago

docker pull atix0/transmission