From 4971f5511a53e8c7fe5d815ad1833c5ea65c56d6 Mon Sep 17 00:00:00 2001 From: miracle091 Date: Sat, 5 Jun 2021 11:49:12 +0200 Subject: [PATCH] Aggiunto transmission --- README.md | 1 + transmission/.env | 12 ++++ transmission/README.md | 102 ++++++++++++++++++++++++++++++++ transmission/docker-compose.yml | 21 +++++++ 4 files changed, 136 insertions(+) create mode 100644 transmission/.env create mode 100644 transmission/README.md create mode 100644 transmission/docker-compose.yml diff --git a/README.md b/README.md index 93f5a5c..523b0c8 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ * [navidrome](navidrome/) - ascolto e gestione di file musicali (MP3/M4A/etc) * [podgrab](podgrab/) - ascolto e gestione di podcast * [syncthing](syncthing/) - simil-dropbox ma decentralizzato +* [transmissionbt](transmissionbt/) - client bittorrent * [unifi-controller](unifi/) - gestione dell'hardware ubiquiti * [watchotwer](watchtower/) - aggiornamento automatico delle immagini * altri in arrivo, stay tuned™ diff --git a/transmission/.env b/transmission/.env new file mode 100644 index 0000000..575ddd9 --- /dev/null +++ b/transmission/.env @@ -0,0 +1,12 @@ +# Generale +TRANSMISSION_CONFIG=/home/docker/transmission/config +TRANSMISSION_DOWNLOADS=/home/docker/transmission/downloads +TRANSMISSION_WEBUI_PORT=9091 +TRANSMISSION_TCP_PORT=51413 +TRANSMISSION_UDP_PORT=51413 + +# transmission +TZ=Europe/Amsterdam +USER=nomeutente +PASS=password +TRANSMISSION_WEB_HOME=/combustion-release/ # scegliere tra /combustion-release/, /transmission-web-control/, /kettu/ e /flood-for-transmission/ \ No newline at end of file diff --git a/transmission/README.md b/transmission/README.md new file mode 100644 index 0000000..cd906d4 --- /dev/null +++ b/transmission/README.md @@ -0,0 +1,102 @@ +# Transmission +
+ +
+ +## Descrizione +[Sito ufficiale](https://transmissionbt.com/) - [Repo (Github)](https://github.com/transmission/transmission) - [Docs](https://docs.linuxserver.io/images/docker-transmission) + +Transmission è un client bitorrent open-source e leggero: +- Supporto a varie interfacce web, [Combustion](https://github.com/Secretmapper/combustion), [Transmission Web Control](https://github.com/ronggang/transmission-web-control), [kettu](https://github.com/endor/kettu) e [Flood for Transmission](https://github.com/johman10/flood-for-transmission) +- Supporto a [PHE](https://wikiless.org/wiki/BitTorrent_protocol_encryption), [DHT](https://wikiless.org/wiki/Distributed_hash_table), [µTP](https://wikiless.org/wiki/Micro_Transport_Protocol), [PEX](https://wikiless.org/wiki/Peer_exchange), [LPD](https://wikiless.org/wiki/Local_Peer_Discovery) e [Magnet](https://wikiless.org/wiki/Magnet_URI_scheme) +- Esistono molti [client](https://transmissionbt.com/resources/) sia ufficiali che di terze parti per le piattaforme più usate + +## Struttura file e cartelle +``` +/home/ +└── docker/ + └── transmission/ + ├── config/ + ├── downloads/ + ├── .env + └── docker-compose.yml +``` + +* `config/` - cartella dove risiedono i dati che servono a transmission +* `downloads/` - cartella dove vengono scaricati e mantenuti i file relativi ai torrent +* `.env` - file contenenti le variabili environment per il docker compose +* `docker-compose.yml` - file usato per creare il container + +**N.B. Tutti i file e le cartelle devono essere creati a mano.** + +## Esempi +Semplice esempio per iniziare ad usare subito il container + +### docker-compose +`docker-compose.yml` +```yml +version: "3.5" +services: + transmission: + container_name: linuxserver-transmission + image: ghcr.io/linuxserver/transmission + networks: + - custom-bridge + restart: unless-stopped + ports: + - ${TRANSMISSION_WEBUI_PORT:-9091}:9091 + - ${TRANSMISSION_TCP_PORT:-51413}:51413 + - ${TRANSMISSION_UDP_PORT:-51413}/udp:51413/udp + env_file: .env + volumes: + - ${TRANSMISSION_CONFIG:-/home/docker/transmission/config}:/config + - ${TRANSMISSION_DOWNLOADS:-/home/docker/transmission/downloads}:/downloads + +networks: + custom-bridge: + name: custom-bridge + driver: bridge +``` + +`.env` +```bash +# Generale +TRANSMISSION_CONFIG=/home/docker/transmission/config +TRANSMISSION_DOWNLOADS=/home/docker/transmission/downloads +TRANSMISSION_WEBUI_PORT=9091 +TRANSMISSION_TCP_PORT=51413 +TRANSMISSION_UDP_PORT=51413 + +# transmission +TZ=Europe/Amsterdam +USER=nomeutente +PASS=password +TRANSMISSION_WEB_HOME=/combustion-release/ # scegliere tra /combustion-release/, /transmission-web-control/, /kettu/ e /flood-for-transmission/ +``` + +# Reverse proxy +Ancora non ho previsto l'uso di un reverse proxy (Vedi [Todo](#Todo)) + +# Aggiornamento +### Automatico +Usando [watchtower](../watchtower) il container si aggiorna automaticamente + +### Manuale +1. `docker-compose pull` +2. `docker-compose up -d` +3. `docker image prune` + +## Backup e ripristino +### Backup +Usate [borg](../borg_backup) per fare i backup giornalieri dell'intera cartella `transmission` + +### Ripristino +Per una maggiore spiegazione sui passaggi da fare, controllate [qua](../borg_backup#user-content-controllare-la-cartella-dei-backup) +* fermare il container `docker-compose down` +* cancellare l'intera cartella `transmission` +* dal backup copiare la cartella `transmission` +* far ripartire il container `docker-compose up -d` + +## Todo +Implementare: +- reverse proxy: **[caddy](https://caddyserver.com/)** o **[traefik](https://doc.traefik.io/traefik/)** diff --git a/transmission/docker-compose.yml b/transmission/docker-compose.yml new file mode 100644 index 0000000..5bb6c2e --- /dev/null +++ b/transmission/docker-compose.yml @@ -0,0 +1,21 @@ +version: "3.5" +services: + transmission: + container_name: linuxserver-transmission + image: ghcr.io/linuxserver/transmission + networks: + - custom-bridge + restart: unless-stopped + ports: + - ${TRANSMISSION_WEBUI_PORT:-9091}:9091 + - ${TRANSMISSION_TCP_PORT:-51413}:51413 + - ${TRANSMISSION_UDP_PORT:-51413}/udp:51413/udp + env_file: .env + volumes: + - ${TRANSMISSION_CONFIG:-/home/docker/transmission/config}:/config + - ${TRANSMISSION_DOWNLOADS:-/home/docker/transmission/downloads}:/downloads + +networks: + custom-bridge: + name: custom-bridge + driver: bridge \ No newline at end of file