forked from linuxserver/docker-transmission
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme-vars.yml
110 lines (93 loc) · 6.3 KB
/
readme-vars.yml
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
---
# project information
project_name: transmission
project_url: "https://www.transmissionbt.com/"
project_logo: "https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/transmission.png"
project_blurb: "[{{ project_name|capitalize }}]({{ project_url }}) is designed for easy, powerful use. Transmission has the features you want from a BitTorrent client: encryption, a web interface, peer exchange, magnet links, DHT, µTP, UPnP and NAT-PMP port forwarding, webseed support, watch directories, tracker editing, global and per-torrent speed limits, and more."
project_lsio_github_repo_url: "https://github.com/linuxserver/docker-{{ project_name }}"
project_blurb_optional_extras_enabled: false
# supported architectures
available_architectures:
- { arch: "{{ arch_x86_64 }}", tag: "amd64-latest"}
- { arch: "{{ arch_arm64 }}", tag: "arm64v8-latest"}
- { arch: "{{ arch_armhf }}", tag: "arm32v7-latest"}
# development version
development_versions: false
# container parameters
common_param_env_vars_enabled: true
param_container_name: "{{ project_name }}"
param_usage_include_net: false
param_usage_include_env: true
param_env_vars:
- { env_var: "TZ", env_value: "Europe/London", desc: "Specify a timezone to use EG Europe/London." }
param_usage_include_vols: true
param_volumes:
- { vol_path: "/config", vol_host_path: "<path to data>", desc: "Where transmission should store config files and logs." }
- { vol_path: "/downloads", vol_host_path: "<path to downloads>", desc: "Local path for downloads." }
- { vol_path: "/watch", vol_host_path: "<path to watch folder>", desc: "Watch folder for torrent files." }
param_usage_include_ports: true
param_ports:
- { external_port: "9091", internal_port: "9091", port_desc: "WebUI" }
- { external_port: "51413", internal_port: "51413", port_desc: "Torrent Port TCP" }
- { external_port: "51413", internal_port: "51413/udp", port_desc: "Torrent Port UDP" }
param_device_map: false
cap_add_param: false
# optional container parameters
opt_param_usage_include_env: true
opt_param_env_vars:
- { env_var: "TRANSMISSION_WEB_HOME", env_value: "/combustion-release/", desc: "Specify an alternative UI options are `/combustion-release/`, `/transmission-web-control/`, and `/kettu/` ." }
- { env_var: "USER", env_value: "username", desc: "Specify an optional username for the interface" }
- { env_var: "PASS", env_value: "password", desc: "Specify an optional password for the interface" }
- { env_var: "WHITELIST", env_value: "iplist", desc: "Specify an optional list of comma separated host whitelist"}
opt_param_usage_include_vols: false
opt_param_usage_include_ports: false
opt_param_device_map: false
opt_cap_add_param: false
optional_block_1: false
# application setup block
app_setup_block_enabled: true
app_setup_block: |
Webui is on port 9091, the settings.json file in /config has extra settings not available in the webui. Stop the container before editing it or any changes won't be saved.
If you choose to use transmission-web-control as your default UI, just note that the origional Web UI will not be available to you despite the button being present.
## Securing the webui with a username/password.
Use the `USER` and `PASS` variables in docker run/create/compose to set authentication. Do not manually edit the `settings.json` to input user/pass, otherwise transmission cannot be stopped cleanly by the s6 supervisor.
## Updating Blocklists Automatically
This requires `"blocklist-enabled": true,` to be set. By setting this to true, it is assumed you have also populated `blocklist-url` with a valid block list.
The automatic update is a shell script that downloads a blocklist from the url stored in the settings.json, gunzips it, and restarts the transmission daemon.
The automatic update will run once a day at 3am local server time.
## Using whitelist
Use `WHITELIST` to enable an ip of whitelist. Both notation `rpc-whitelist` and `rpc-host-whitelist` are supported. When `WHITELIST` is empty the whitelist is disabled.
# changelog
changelogs:
- { date: "23.01.21:", desc: "Rebasing to alpine 3.13." }
- { date: "02.11.20:", desc: "Add ca-certificates package to allow connecting to https trackers." }
- { date: "02.06.20:", desc: "Rebase to alpine 3.12, update to transmission 3.0, remove python2, add python3." }
- { date: "11.05.20:", desc: "Remove unnecessary chmod (remnant of previous change)." }
- { date: "28.04.20:", desc: "Use transmission-remote to update blocklist." }
- { date: "30.03.20:", desc: "Internalize blocklist-update.sh." }
- { date: "29.03.20:", desc: "Update auth info in readme." }
- { date: "19.12.19:", desc: "Rebasing to alpine 3.11." }
- { date: "04.10.19:", desc: "Update package label." }
- { date: "21.08.19:", desc: "Add optional user/pass environment variables, fix transmission shut down if user/pass are set." }
- { date: "19.07.19:", desc: "Send SIGTERM in blocklist update to properly close pid." }
- { date: "28.06.19:", desc: "Rebasing to alpine 3.10." }
- { date: "23.03.19:", desc: "Switching to new Base images, shift to arm32v7 tag." }
- { date: "22.02.19:", desc: "Rebase to Alpine 3.9, add themes to baseimage, add python and findutils." }
- { date: "22.02.19:", desc: "Catch term and clean exit." }
- { date: "07.02.19:", desc: "Add pipeline logic and multi arch." }
- { date: "15.08.18:", desc: "Rebase to alpine linux 3.8." }
- { date: "12.02.18:", desc: "Pull transmission from edge repo." }
- { date: "10.01.18:", desc: "Rebase to alpine linux 3.7." }
- { date: "25.07.17:", desc: "Add rsync package." }
- { date: "27.05.17:", desc: "Rebase to alpine linux 3.6." }
- { date: "06.02.17:", desc: "Rebase to alpine linux 3.5." }
- { date: "15.01.17:", desc: "Add p7zip, tar , unrar and unzip packages." }
- { date: "16.10.16:", desc: "Blocklist autoupdate with optional authentication." }
- { date: "14.10.16:", desc: "Add version layer informationE." }
- { date: "23.09.16:", desc: "Add information about securing the webui to README." }
- { date: "21.09.16:", desc: "Add curl package." }
- { date: "09.09.16:", desc: "Add layer badges to README." }
- { date: "28.08.16:", desc: "Add badges to README." }
- { date: "09.08.16:", desc: "Rebase to alpine linux." }
- { date: "06.12.15:", desc: "Separate mapping for watch folder." }
- { date: "16.11.15:", desc: "Initial Release." }