From fcafec579d92da2ae0d5952d9b63f6806ed0b0bd Mon Sep 17 00:00:00 2001
From: cyril <cyril@x1c6.hsd1.co.comcast.net>
Date: Sat, 13 Jul 2024 20:43:12 -0600
Subject: [PATCH] server-trans.md: Add Docker procedure

---
 server-trans.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 68 insertions(+), 2 deletions(-)

diff --git a/server-trans.md b/server-trans.md
index 0dfa508..22d151c 100644
--- a/server-trans.md
+++ b/server-trans.md
@@ -1,6 +1,72 @@
-## Torrent | Transmission
+# Torrent | Transmission
+1. [Docker container installation](#docker-container-installation) (For use on immutable OS)
+2. [Traditional linux installation](#traditional-linux-installation)
 
-### Transmission@server  
+## Docker container installation
+
+Setup the directory structure
+```sh
+mkdir -p /etc/transmission/config
+mkdir -p /var/storage/watch
+```
+
+Create `/etc/transmission/docker-compose.yml`  
+Defines core transmission-server parameters  
+and maps host ports & directories to the container
+```
+---
+services:
+  transmission:
+    image: lscr.io/linuxserver/transmission:latest
+    container_name: transmission
+    environment:
+      - PUID=1000
+      - PGID=100
+      - TZ=America/Denver
+      - TRANSMISSION_WEB_HOME= #optional
+      - USER= #optional
+      - PASS= #optional
+      - WHITELIST=127.0.0.1,192.168.9.*
+      - PEERPORT=51417
+      - HOST_WHITELIST=dubserv
+    volumes:
+      - /etc/transmission/config:/config
+      - /var/storage:/storage
+      - /var/storage/watch:/watch
+    ports:
+      - 9091:9091
+      - 51413:51413
+      - 51413:51413/udp
+    restart: unless-stopped
+
+```
+
+Create `/etc/systemd/system/transmission.service` unit file  
+so that transmission container is automatically launched at boot  
+```
+[Unit]
+Description=Service for Transmission container
+Requires=docker.service
+After=docker.service
+
+[Service]
+Type=oneshot
+WorkingDirectory=/etc/transmission/
+ExecStart=/usr/bin/docker-compose -f docker-compose.yml up -d
+ExecStop=/usr/bin/docker-compose -f docker-compose.yml stop
+StandardOutput=syslog
+RemainAfterExit=yes
+
+[Install]
+WantedBy=default.target
+```
+
+### Notes:  
+- `Systemctl daemon-reload` for each edit of `transmission.service`
+- Am able to set webUI torrent location to `/any/path/I/choose`, and it will create the directories as needed on the host OS under `/var/storage` (as defined by the `docker-compose.yml`)
+- Ref: https://docs.linuxserver.io/images/docker-transmission/
+
+## Traditional linux installation
 192.168.9.13:9091 :: dubserv:9091 :: [ref_Transmission_Docs_headless](https://github.com/transmission/transmission/blob/main/docs/Headless-Usage.md) :: [ref_Fedora-spec](https://ask.fedoraproject.org/en/question/67980/how-do-i-use-transmission-from-server-21/) :: [ref_ubuntu-inst](https://help.ubuntu.com/community/TransmissionHowTo) ::  
 
 -------------