diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml index 6e83f87..412ba6b 100644 --- a/.github/workflows/validate.yml +++ b/.github/workflows/validate.yml @@ -11,7 +11,7 @@ jobs: scripts-and-compose: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v7 - name: Install validation tools run: | diff --git a/README.md b/README.md index 032f423..fdff5ad 100644 --- a/README.md +++ b/README.md @@ -1,53 +1,43 @@ # Media Stack dla Proxmox LXC -Produkcyjny instalator kompletnego stacku multimedialnego. Główny skrypt jest -uruchamiany **na serwerze Proxmox VE**: tworzy osobny, nieuprzywilejowany LXC z -Debianem 13, przygotowuje urządzenia i uruchamia instalator aplikacji **wewnątrz -tego LXC**. +Powtarzalny instalator produkcyjnego stacku multimedialnego dla Proxmox VE. +Główny skrypt uruchamia się na hoście Proxmox, tworzy **nieuprzywilejowany LXC z Debianem 13**, przygotowuje storage i urządzenia, a następnie instaluje Dockera oraz cały stack wyłącznie wewnątrz kontenera. -Docker ani żadna aplikacja multimedialna nie są instalowane na hoście Proxmox. +Projekt celowo zajmuje się tylko warstwą mediów. Zdalny dostęp, reverse proxy i inne elementy infrastruktury sieciowej są konfigurowane poza tym LXC. ## Co powstaje ```text -Proxmox VE host -└── nieuprzywilejowany LXC „media” +Proxmox VE +└── LXC media (unprivileged, Debian 13) ├── Docker Engine + Compose - ├── Gluetun → ProtonVPN → Transmission - ├── Radarr, Sonarr, Prowlarr, Bazarr - ├── Jellyfin i Seerr + ├── Gluetun → ProtonVPN + │ └── Transmission + ├── Sonarr + ├── Radarr + ├── Prowlarr + ├── Bazarr + ├── Jellyfin + ├── Seerr ├── opcjonalny FlareSolverr - ├── opcjonalny Newt → Pangolin - ├── opcjonalny Tailscale - ├── automatyczne spięcie aplikacji ARR - ├── synchronizacja portu ProtonVPN → Transmission + ├── automatyczne spięcie *Arr + Bazarr + ├── synchronizacja forwarded port ProtonVPN → Transmission + ├── diagnostyka storage/VPN/iGPU/usług └── opóźnione aktualizacje z backupem i rollbackiem ``` -Provisioner może również przekazać urządzenie renderujące Intel/AMD do Jellyfin -i utworzyć osobny, zarządzany przez Proxmox wolumin na media. +## Założenia -## Najszybsza instalacja +- Proxmox VE jako host. +- Płatny ProtonVPN z obsługą port forwardingu. +- **WireGuard jest domyślnym i zalecanym protokołem VPN.** +- OpenVPN pozostaje dostępny jako fallback. +- Media i downloady powinny znajdować się na jednym filesystemie, aby Sonarr/Radarr mogły używać hardlinków. +- Jellyfin może dostać `/dev/dri/renderD128` do sprzętowego transkodowania Intel/AMD. -### 1. Przygotuj dane +## Instalacja -Przed startem warto mieć: - -- płatne konto ProtonVPN z port forwardingiem; -- dla zalecanego WireGuard: klucz `PrivateKey` z konfiguracji ProtonVPN - wygenerowanej z włączonym NAT-PMP; -- albo osobny login i hasło OpenVPN z panelu ProtonVPN — nie dane konta; -- opcjonalnie endpoint, ID i sekret Newt z Pangolin; -- opcjonalnie konto Tailscale; -- adresację sieci: DHCP z rezerwacją lub statyczny IPv4; -- decyzję, na którym storage Proxmox mają znajdować się system i media. - -OpenVPN wymaga sufiksu `+pmp`; instalator dodaje go sam i nie dubluje, jeśli już -jest obecny. - -### 2. Uruchom provisioner na hoście Proxmox - -Zaloguj się do powłoki **hosta Proxmox jako root** i pobierz skrypt do pliku: +Na hoście Proxmox jako `root`: ```bash installer=$(mktemp) @@ -56,274 +46,230 @@ bash "$installer" rm -f "$installer" ``` -Nie uruchamiaj tego polecenia na laptopie ani stacji roboczej. Provisioner ma -twardą kontrolę środowiska i zakończy się, jeśli nie wykryje hosta Proxmox VE. +Nie używaj `curl | bash`. Provisioner wymaga interaktywnego terminala i pokazuje plan przed utworzeniem LXC. -Nie używaj `curl | bash`. Provisioner celowo wymaga interaktywnego terminala i -przed utworzeniem LXC wyświetla kompletny plan do zatwierdzenia. +### Provisioner pyta tylko o rzeczy, których nie da się bezpiecznie zgadnąć -Skrypt poprosi o: +1. CT ID i hostname; +2. storage LXC; +3. CPU/RAM/swap; +4. DHCP lub statyczny IPv4 i opcjonalny VLAN; +5. gdzie mają leżeć media; +6. opcjonalne przekazanie iGPU; +7. dane ProtonVPN; +8. login do Transmission; +9. czy uruchomić FlareSolverr; +10. opcjonalny zewnętrzny katalog backupu. -1. nowy CT ID i hostname; -2. storage oraz rozmiar dysku systemowego; -3. CPU, RAM i swap; -4. bridge, DHCP/statyczny IPv4 i opcjonalny VLAN; -5. opcjonalny osobny wolumin `/opt/media-stack/data`; -6. czy ten wolumin ma wejść do backupów `vzdump`; -7. opcjonalne przekazanie iGPU; -8. ostateczne potwierdzenie utworzenia LXC. +Domyślny rootfs LXC to **64 GiB**. Dane multimedialne mogą być osobnym woluminem Proxmox albo istniejącym filesystemem hosta. -Następnie automatycznie: +## VPN i Transmission -- odświeży katalog `pveam` i pobierze najnowszy szablon Debian 13; -- utworzy nowy, nieuprzywilejowany LXC; -- włączy `nesting=1` i `keyctl=1` wymagane przez Docker; -- przekaże `/dev/net/tun` wymagany przez Gluetun i Tailscale; -- uruchomi LXC i poczeka na systemd, sieć oraz TUN; -- przeniesie do LXC jeden spójny snapshot projektu; -- uruchomi wewnętrzny kreator usług. +Domyślnie instalator wybiera **WireGuard**. Należy podać `PrivateKey` z konfiguracji ProtonVPN przygotowanej do port forwardingu. -Druga seria pytań widoczna w tym samym terminalu dotyczy już wyłącznie -konfiguracji wewnątrz LXC: VPN, Pangolin, Transmission, Tailscale, FlareSolverr, -backupu zewnętrznego oraz transkodowania sprzętowego. +Transmission nie ma własnego namespace sieciowego: -Po udanej instalacji CT otrzymuje ochronę Proxmox przed przypadkowym usunięciem. +```text +Transmission + │ + └── network_mode: service:gluetun + │ + └── ProtonVPN +``` -## Ważne decyzje +Dzięki temu Transmission korzysta bezpośrednio z sieci Gluetun. Forwarded port jest pobierany w pierwszej kolejności z control API Gluetun, a dla zgodności z serią v3 dostępny jest fallback do pliku statusowego. Port jest następnie ustawiany przez uwierzytelnione RPC Transmission. -### Sieć +OpenVPN jest obsługiwany jako fallback i używa osobnych danych OpenVPN ProtonVPN. Instalator automatycznie dodaje wymagany sufiks `+pmp`, jeśli go brakuje. -Najprościej wybrać DHCP i ustawić w routerze rezerwację dla MAC nowego LXC. -Można też od razu podać statyczny IPv4. Panele Dockera są wiązane tylko z -loopbackiem i konkretnym adresem LAN, dlatego nie są przypadkowo publikowane na -każdym interfejsie. +## Storage i hardlinki -Jeśli adres LXC później się zmieni: +Wszystkie aplikacje widzą jedno drzewo `/data`: -```bash -pct exec CTID -- media-stack repair-ip +```text +/data +├── torrents +│ ├── incomplete +│ ├── movies +│ └── tv +└── media + ├── movies + └── tv ``` -Polecenie wykryje nowy adres, atomowo zmieni `.env`, odtworzy bindingi i w razie -błędu przywróci poprzednią konfigurację. +Taki układ pozwala Sonarr/Radarr importować pliki przez hardlink zamiast kopiować je między osobnymi mountami. -### Storage +Dla istniejącego filesystemu hosta provisioner: -Provisioner może utworzyć osobny wolumin Proxmox zamontowany jako -`/opt/media-stack/data`. Dla NAS lub istniejącego bind mountu najlepiej najpierw -utworzyć LXC provisionerem bez woluminu danych, zatrzymać go, dodać świadomie -mapowany mount i dopiero wewnątrz LXC ponownie uruchomić `install_media.sh`. +- odmawia użycia ścieżki znajdującej się na rootfs Proxmoxa; +- mapuje UID/GID nieuprzywilejowanego LXC; +- sprawdza faktyczny zapis jako użytkownik aplikacji; +- wykonuje test hardlinka; +- zapisuje sentinel identyfikujący właściwy filesystem; +- dodaje `ExecStartPre` do Dockera, który blokuje start, jeśli właściwy dysk zniknie lub pod mountpointem pojawi się inny filesystem. -W nieuprzywilejowanym LXC UID 1000 jest mapowany na UID 101000 hosta Proxmox. -Instalator testuje realny zapis jako użytkownik mediów i zatrzymuje się z jasnym -błędem, jeśli mapowanie jest niepoprawne. Nie wykonuje rekurencyjnego `chown` na -całej istniejącej bibliotece. +To zapobiega przypadkowemu zapisywaniu filmów na dysku systemowym po awarii mounta. -Katalogi pobierania i bibliotek są częścią jednego drzewa `/data`, a instalator -sprawdza możliwość tworzenia hardlinków. +## Co konfiguruje się automatycznie -### VPN +Po pierwszym starcie `media-stack configure` ustawia idempotentnie: -WireGuard jest domyślnym zaleceniem ze względu na mniejszy narzut. Obsługiwany -jest również OpenVPN. W obu wariantach Transmission używa bezpośrednio -przestrzeni sieciowej Gluetun (`network_mode: service:gluetun`), więc utrata VPN -odcina mu wyjście zamiast przełączać ruch na zwykły interfejs LXC. +- `/data/media/movies` jako root folder Radarr; +- `/data/media/tv` jako root folder Sonarr; +- Transmission jako download client Radarr i Sonarr; +- kategorię `movies` dla Radarr; +- kategorię `tv` dla Sonarr; +- Prowlarr → Radarr z `fullSync`; +- Prowlarr → Sonarr z `fullSync`; +- Bazarr → Sonarr wraz z API key; +- Bazarr → Radarr wraz z API key. -Losowy port przydzielony przez ProtonVPN jest co minutę odczytywany z Gluetun i -ustawiany przez uwierzytelnione API Transmission. Skrypt nie parsuje logów i nie -wymaga ręcznej zmiany portu po reconnectcie. +Instalator wywołuje tę konfigurację sam po pierwszym uruchomieniu. Polecenie można bezpiecznie powtarzać: -### Dostęp zdalny +```bash +media-stack configure +``` -Pangolin i Tailscale są niezależne i opcjonalne: +### Co nadal wymaga decyzji użytkownika -- Pangolin publikuje deklaratywnie tylko Jellyfin oraz Seerr; -- Newt czyta metadane kontenerów przez ograniczony Docker Socket Proxy, nie przez - bezpośrednio zamontowane gniazdo Dockera; -- panele administracyjne nie mają etykiet publicznych; -- Tailscale Serve udostępnia prywatne endpointy HTTPS dla wszystkich paneli. +Tego projekt nie zgaduje, ponieważ są to dane konta albo preferencje: -## Model dostępu +- utworzenie pierwszego konta Jellyfin; +- wybór bibliotek i ustawień odtwarzania w Jellyfin; +- pierwsze logowanie i wybór serwera biblioteki w Seerr; +- indexery w Prowlarr; +- profile jakości i polityka pobierania; +- języki/profil napisów w Bazarr. -| Usługa | LAN | Tailscale | Pangolin publiczny | -| --- | :---: | :---: | :---: | -| Jellyfin | Tak | Tak | Tak | -| Seerr | Tak | Tak | Tak, domyślnie z SSO | -| Transmission | Tak | Tak | Nie | -| Radarr | Tak | Tak | Nie | -| Sonarr | Tak | Tak | Nie | -| Prowlarr | Tak | Tak | Nie | -| Bazarr | Tak | Tak | Nie | -| FlareSolverr | Nie | Nie | Nie | +Poza tym połączenia pomiędzy aplikacjami są wykonywane automatycznie. -Nie przekierowuj tych portów na routerze. Publiczny dostęp powinien przechodzić -wyłącznie przez Pangolin, a administracja zdalna przez polityki Tailscale. +## iGPU / sprzętowe transkodowanie Jellyfin -## Co jest konfigurowane automatycznie +Jeśli host ma `/dev/dri/renderD128`, provisioner proponuje przekazanie tego urządzenia do LXC. Do Jellyfin trafia tylko render node, a kontener otrzymuje właściwy GID urządzenia. -Po pierwszym starcie `media-stack configure` używa bieżących schematów API -aplikacji, zamiast polegać na sztywnym JSON-ie konkretnej wersji. Operacja jest -idempotentna i ustawia: +`media-stack doctor` sprawdza wtedy: -- `/data/media/movies` jako root folder Radarr; -- `/data/media/tv` jako root folder Sonarr; -- Transmission jako download client obu aplikacji; -- kategorię `movies` dla Radarr i `tv` dla Sonarr; -- pełną synchronizację Prowlarr z Radarr i Sonarr; -- wewnętrzne adresy kontenerów bez Remote Path Mappings. +- czy render node istnieje w LXC; +- czy widzi go kontener Jellyfin; +- czy `vainfo` z pakietu Jellyfin FFmpeg potrafi otworzyć urządzenie DRM. -Ręcznie pozostają czynności wymagające decyzji użytkownika: konto i biblioteki -Jellyfin, logowanie Seerr, profile jakości, indexery oraz ewentualny proxy -FlareSolverr. +Po instalacji nadal należy w panelu Jellyfin wybrać sprzętową akcelerację właściwą dla sprzętu. -Jeśli automatyczne spięcie wykonało się zanim aplikacje były gotowe, można je -bezpiecznie powtórzyć: +## Zarządzanie + +W LXC: ```bash -pct exec CTID -- media-stack configure +media-stack status +media-stack doctor +media-stack configure +media-stack backup +media-stack logs gluetun +media-stack logs jellyfin ``` -## Zarządzanie z hosta Proxmox +Z hosta Proxmox: ```bash -# stan kontenerów i adresy pct exec CTID -- media-stack status - -# pełna diagnostyka: TUN, storage, hardlinki, healthchecki, VPN i timery pct exec CTID -- media-stack doctor - -# logi jednej usługi -pct exec CTID -- media-stack logs gluetun - -# spójny backup konfiguracji przy zatrzymanym stacku -pct exec CTID -- media-stack backup - -# wejście do LXC +pct exec CTID -- media-stack configure pct enter CTID ``` -Przydatne polecenia już wewnątrz LXC: +Jeśli adres IP LXC zmieni się mimo rezerwacji DHCP: ```bash -media-stack status -media-stack doctor -cd /opt/media-stack && docker compose ps -systemctl status media-stack-update.timer -systemctl status media-stack-port-sync.timer -journalctl -u media-stack-update.service -n 100 --no-pager -journalctl -u media-stack-port-sync.service -n 100 --no-pager +media-stack repair-ip ``` -## Aktualizacje i rollback +Polecenie wykryje aktualny adres, odtworzy bindingi Compose i w razie błędu przywróci poprzednią konfigurację. -Timer nocny pobiera metadane nowych obrazów, ale kandydat musi pozostać -niezmieniony przez siedem dni. Grupy zależnych usług dojrzewają razem: +## Diagnostyka -- Gluetun + Transmission; -- Newt + Docker Socket Proxy; -- pozostałe aplikacje osobno. +`media-stack doctor` sprawdza między innymi: -Przed wdrożeniem stack jest zatrzymywany, a konfiguracja i sekrety trafiają do -sprawdzonego archiwum. Po aktualizacji wymagane są działające kontenery, -healthchecki, endpointy HTTP, brak pętli restartów i aktywny port ProtonVPN przez -pełne 60 sekund. Niepowodzenie przywraca poprzednie obrazy i konfigurację. +- `/dev/net/tun`; +- Docker i model Compose; +- aktualny binding LAN; +- zapis UID/GID do storage; +- hardlinki między `torrents` i `media`; +- stan i healthcheck wszystkich aktywnych kontenerów; +- czy Transmission naprawdę dzieli namespace sieciowy Gluetun; +- endpointy HTTP aplikacji; +- logowanie do Transmission; +- różnicę między publicznym IP LXC i VPN; +- forwarded port ProtonVPN; +- spięcie Bazarr → Sonarr/Radarr; +- iGPU/Jellyfin, jeśli HWA jest włączone; +- timery aktualizacji i synchronizacji portu; +- tożsamość zewnętrznego filesystemu backupowego. -Opcjonalny backup NAS zapisuje także oczekiwane źródło i punkt montowania. -Zmiana lub zniknięcie mountu zatrzymuje backup/aktualizację zamiast zapisać dane -na lokalnym katalogu pod pustym mountpointem. +## Aktualizacje -Lokalnie przechowywanych jest pięć backupów i dwa obrazy rollbacku na usługę; -na zewnętrznym filesystemie dziesięć backupów. +`media-stack-update.timer` uruchamia nocny check. Nowy obraz nie jest wdrażany od razu: kandydat musi pozostać niezmieniony przez domyślnie **7 dni**. -## Sekrety +Zależne usługi aktualizują się razem, np. Gluetun + Transmission. Przed wdrożeniem powstaje backup konfiguracji i tagi rollbacku. Po zmianie wymagane są: -Hasła nie trafiają do `.env`, wygenerowanej instrukcji ani środowiska -kontenerów tam, gdzie upstream obsługuje pliki: +- działające kontenery; +- poprawne healthchecki; +- działające endpointy HTTP; +- brak pętli restartów; +- poprawny forwarded port VPN przez okres stabilizacji. -```text -/opt/media-stack/secrets/ -├── proton_openvpn_user # tylko dla OpenVPN -├── proton_openvpn_password # tylko dla OpenVPN -├── proton_wireguard_private_key # tylko dla WireGuard -├── transmission_user -└── transmission_password -``` +Jeśli walidacja się nie powiedzie, poprzednia konfiguracja i obrazy są automatycznie przywracane. -Pliki mają tryb `0600`. Gluetun i LinuxServer Transmission korzystają z Docker -Compose secrets. Newt używa własnego pliku konfiguracyjnego `0600`. +## Backup -## Instalacja w istniejącym LXC +`media-stack backup` tworzy spójny backup konfiguracji przy zatrzymanym stacku. Obejmuje konfiguracje aplikacji, sekrety, Compose i skrypty zarządzające, ale **nie bibliotekę filmów/seriali**. -Jeśli LXC został już utworzony ręcznie, na hoście Proxmox ustaw co najmniej: +Opcjonalny katalog zewnętrzny jest zapamiętywany wraz z tożsamością źródła i mountpointu. Jeśli mount zniknie albo zostanie podmieniony, backup kończy się błędem zamiast zapisywać pod pustym katalogiem na rootfs. -```bash -pct set CTID --features nesting=1,keyctl=1 -pct set CTID --dev0 /dev/net/tun -pct stop CTID -pct start CTID -``` +Backup tego stacku jest ochroną konfiguracji. Kopie danych ważnych dla całego homelabu powinny być realizowane niezależnie na poziomie infrastruktury. -Następnie wejdź do kontenera (`pct enter CTID`) i wykonaj: +## Sekrety -```bash -apt-get update -apt-get install -y ca-certificates curl -installer=$(mktemp) -curl -fsSL https://raw.githubusercontent.com/placq/media-stack/main/install_media.sh -o "$installer" -bash "$installer" -rm -f "$installer" +Sekrety nie są wpisywane bezpośrednio do Compose: + +```text +/opt/media-stack/secrets/ +├── proton_wireguard_private_key +├── proton_openvpn_user +├── proton_openvpn_password +├── transmission_user +└── transmission_password ``` -`install_media.sh` jest bezpieczny do ponownego uruchomienia: zachowuje puste -sekrety z poprzedniej konfiguracji, waliduje nowy Compose przed podmianą i przy -błędzie odtwarza poprzednie pliki. +Aktywny wariant VPN wykorzystuje pliki sekretów. Niepotrzebne sekrety drugiego protokołu są usuwane podczas rekonfiguracji. -## Diagnostyka awarii provisionera +## Pliki projektu -Provisioner nigdy nie usuwa automatycznie częściowo utworzonego LXC. Jeśli etap -wewnętrzny się nie powiedzie: +| Plik | Rola | +| --- | --- | +| `proxmox_lxc.sh` | tworzy i zabezpiecza LXC na hoście Proxmox | +| `install_media.sh` | instaluje stack wewnątrz LXC | +| `templates/compose.yaml` | główny model usług | +| `templates/compose.wireguard.yaml` | domyślna konfiguracja WireGuard | +| `templates/compose.openvpn.yaml` | fallback OpenVPN | +| `templates/compose.gpu.yaml` | passthrough render node do Jellyfin | +| `media_stack.sh` | status, doctor, automatyczna konfiguracja, backup i naprawa IP | +| `sync_transmission_port.sh` | synchronizacja forwarded port → Transmission | +| `update_stack.sh` | opóźnione aktualizacje, test stabilności i rollback | +| `tests/validate.sh` | statyczne testy kontraktów i wariantów Compose | -```bash -pct config CTID -pct enter CTID -bash /root/media-stack-source/install_media.sh -``` +## Walidacja zmian -Sprawdź przede wszystkim: +Repo uruchamia w GitHub Actions: -```bash -test -c /dev/net/tun && echo TUN_OK -ip route -systemctl status docker --no-pager -cd /opt/media-stack && docker compose logs --tail=100 gluetun -``` +- `bash -n` dla skryptów; +- renderowanie wariantów Compose; +- testy niezmienników bezpieczeństwa; +- ShellCheck. -CT ma po udanej instalacji włączoną ochronę. Przed świadomym usunięciem trzeba ją -wyłączyć: +Lokalnie: ```bash -pct set CTID --protection 0 +bash tests/validate.sh +shellcheck --severity=warning \ + proxmox_lxc.sh install_media.sh media_stack.sh \ + update_stack.sh sync_transmission_port.sh ``` - -## Pliki projektu - -| Plik | Rola | -| --- | --- | -| `proxmox_lxc.sh` | provisioner uruchamiany wyłącznie na hoście Proxmox | -| `install_media.sh` | instalator uruchamiany wyłącznie wewnątrz LXC | -| `templates/compose*.yaml` | testowalne profile stacku | -| `media_stack.sh` | status, doctor, konfiguracja ARR, backup i naprawa IP | -| `sync_transmission_port.sh` | synchronizacja ProtonVPN → Transmission | -| `update_stack.sh` | opóźnione aktualizacje, backup, healthcheck i rollback | - -Projekt opiera konfigurację LXC na oficjalnym `pct`, Dockera na podpisanym -repozytorium APT Docker CE, Tailscale na podpisanym repozytorium APT, a składnię -Pangolin na deklaratywnych blueprintach/etykietach Newt. - -Dokumentacja referencyjna: [Proxmox `pct`](https://pve.proxmox.com/pve-docs/pct.1.html), -[Docker Engine na Debianie](https://docs.docker.com/engine/install/debian/), -[Tailscale w nieuprzywilejowanym LXC](https://tailscale.com/kb/1130/lxc-unprivileged/), -[ProtonVPN port forwarding](https://protonvpn.com/support/port-forwarding-manual-setup), -[Gluetun dla ProtonVPN](https://github.com/qdm12/gluetun-wiki/blob/main/setup/providers/protonvpn.md), -[Pangolin Blueprints](https://docs.pangolin.net/manage/blueprints) oraz -[Docker dla Seerr](https://docs.seerr.dev/getting-started/docker/). diff --git a/install_media.sh b/install_media.sh old mode 100644 new mode 100755 index be1d2da..355ac07 --- a/install_media.sh +++ b/install_media.sh @@ -1,25 +1,19 @@ #!/usr/bin/env bash - set -Eeuo pipefail umask 027 -readonly INSTALLER_VERSION="4.0.0" +readonly INSTALLER_VERSION="5.0.0" readonly DEFAULT_INSTALL_DIR="/opt/media-stack" readonly PROJECT_REPOSITORY="placq/media-stack" -RED='\033[0;31m' -GREEN='\033[0;32m' -YELLOW='\033[1;33m' -BLUE='\033[0;34m' -NC='\033[0m' - +RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; NC='\033[0m' log_info() { printf '%b[INFO]%b %s\n' "$BLUE" "$NC" "$*"; } log_success() { printf '%b[OK]%b %s\n' "$GREEN" "$NC" "$*"; } log_warn() { printf '%b[WARN]%b %s\n' "$YELLOW" "$NC" "$*" >&2; } die() { printf '%b[ERROR]%b %s\n' "$RED" "$NC" "$*" >&2; exit 1; } usage() { - cat <<'EOF' + cat <<'USAGE' Media Stack installer for Debian/Ubuntu LXC Usage: @@ -28,617 +22,312 @@ Usage: bash install_media.sh --help Options: - --preflight Check the host/LXC without changing it. - --help Show this help. - -The normal installation is interactive and safe to run again. Existing -credentials are retained when a secret prompt is left empty. -EOF + --preflight Check the LXC without changing it + --from-proxmox Internal mode used by proxmox_lxc.sh + --help Show this help +USAGE } PREFLIGHT_ONLY=false case "${1:-}" in - "") ;; - --preflight) PREFLIGHT_ONLY=true ;; - --from-proxmox) - [[ "${MEDIA_STACK_PROXMOX_LAUNCH:-}" == 1 ]] || die "--from-proxmox is reserved for proxmox_lxc.sh." - ;; - --help|-h) usage; exit 0 ;; - *) usage >&2; die "Unknown option: $1" ;; + "") ;; + --preflight) PREFLIGHT_ONLY=true ;; + --from-proxmox) [[ "${MEDIA_STACK_PROXMOX_LAUNCH:-}" == 1 ]] || die "--from-proxmox is reserved for proxmox_lxc.sh" ;; + --help|-h) usage; exit 0 ;; + *) usage >&2; die "Unknown option: $1" ;; esac -[[ $EUID -eq 0 ]] || die "Run this installer as root (or with sudo)." +[[ $EUID -eq 0 ]] || die "Run this installer as root" if ! $PREFLIGHT_ONLY && [[ "${MEDIA_STACK_PROXMOX_LAUNCH:-}" != 1 ]]; then - [[ -t 0 ]] || die "An interactive terminal is required. Download the script first; do not pipe it to bash." + [[ -t 0 ]] || die "Interactive terminal required; download the script first instead of piping it to bash" fi -[[ "$(ps -p 1 -o comm=)" == systemd ]] || die "systemd must be PID 1." - +[[ "$(ps -p 1 -o comm=)" == systemd ]] || die "systemd must be PID 1" # shellcheck disable=SC1091 source /etc/os-release -case "${ID:-}" in - debian|ubuntu) ;; - *) die "Supported systems: Debian and Ubuntu." ;; -esac -[[ -n "${VERSION_CODENAME:-}" ]] || die "Unable to determine the OS codename." - +case "${ID:-}" in debian|ubuntu) ;; *) die "Supported systems: Debian and Ubuntu" ;; esac +[[ -n "${VERSION_CODENAME:-}" ]] || die "Unable to determine OS codename" VIRT=$(systemd-detect-virt --container 2>/dev/null || true) -[[ "$VIRT" == lxc ]] || - die "This installer runs only inside an LXC (detected: ${VIRT:-none}). On the Proxmox host use proxmox_lxc.sh." -[[ -c /dev/net/tun && -r /dev/net/tun && -w /dev/net/tun ]] || - die "LXC has no usable /dev/net/tun. On Proxmox enable nesting,keyctl and pass /dev/net/tun, then stop/start the CT." -[[ -c /dev/net/tun ]] || die "/dev/net/tun is required by Gluetun and Tailscale." - -AVAILABLE_MEMORY_MB=$(awk '/MemAvailable:/ {print int($2 / 1024)}' /proc/meminfo) -((AVAILABLE_MEMORY_MB >= 1800)) || log_warn "Only ${AVAILABLE_MEMORY_MB} MiB of memory is currently available; 4 GiB or more is recommended." - -ROOT_FREE_MB=$(df -Pm / | awk 'NR == 2 {print $4}') -((ROOT_FREE_MB >= 8192)) || log_warn "Less than 8 GiB is free on the root filesystem. Image pulls may fail." +[[ "$VIRT" == lxc ]] || die "This installer runs only inside LXC (detected: ${VIRT:-none})" +[[ -c /dev/net/tun && -r /dev/net/tun && -w /dev/net/tun ]] || die "LXC has no usable /dev/net/tun; Gluetun requires it" +AVAILABLE_MEMORY_MB=$(awk '/MemAvailable:/ {print int($2/1024)}' /proc/meminfo) +((AVAILABLE_MEMORY_MB >= 1800)) || log_warn "Only ${AVAILABLE_MEMORY_MB} MiB RAM is currently available" +ROOT_FREE_MB=$(df -Pm / | awk 'NR==2 {print $4}') +((ROOT_FREE_MB >= 8192)) || log_warn "Less than 8 GiB is free on the root filesystem" if $PREFLIGHT_ONLY; then - command -v ip >/dev/null || die "Missing iproute2 (the ip command)." - ip -4 route show default | grep -q . || die "No IPv4 default route was found." - log_success "Preflight passed: ${PRETTY_NAME:-$ID}, virtualization=${VIRT:-none}, TUN usable, ${AVAILABLE_MEMORY_MB} MiB available." - exit 0 + command -v ip >/dev/null || die "Missing iproute2" + ip -4 route show default | grep -q . || die "No IPv4 default route" + log_success "Preflight passed: ${PRETTY_NAME:-$ID}, LXC, TUN usable, ${AVAILABLE_MEMORY_MB} MiB available" + exit 0 fi mkdir -p /run/lock exec 8>/run/lock/media-stack-installer.lock -flock -n 8 || die "Another Media Stack installation is already running." - +flock -n 8 || die "Another Media Stack installation is running" TEMP_DIR=$(mktemp -d) -JELLYSEERR_WAS_RUNNING=false -JELLYSEERR_MIGRATED=false DEPLOYMENT_STARTED=false DEPLOYMENT_FINISHED=false ROLLBACK_ARCHIVE="" INSTALL_DIR="" - cleanup() { - local status=$? - trap - EXIT - rm -rf -- "$TEMP_DIR" - if ((status != 0)); then - printf '%b[ERROR]%b Installation failed.\n' "$RED" "$NC" >&2 - if $DEPLOYMENT_STARTED && ! $DEPLOYMENT_FINISHED && [[ -n "$ROLLBACK_ARCHIVE" && -s "$ROLLBACK_ARCHIVE" ]]; then - log_warn "Restoring the previous generated configuration." - rm -f "$INSTALL_DIR/.env" "$INSTALL_DIR/compose.yaml" "$INSTALL_DIR/compose.openvpn.yaml" \ - "$INSTALL_DIR/compose.wireguard.yaml" "$INSTALL_DIR/compose.gpu.yaml" \ - "$INSTALL_DIR/update_stack.sh" "$INSTALL_DIR/sync_transmission_port.sh" \ - "$INSTALL_DIR/media_stack.sh" "$INSTALL_DIR/important_info.md" \ - "$INSTALL_DIR/config/newt/config.json" - rm -rf -- "$INSTALL_DIR/secrets" - tar -xzf "$ROLLBACK_ARCHIVE" -C "$INSTALL_DIR" || true - ( - if cd "$INSTALL_DIR"; then - docker compose up -d --remove-orphans - fi - ) || true - fi - if $JELLYSEERR_WAS_RUNNING && command -v docker >/dev/null; then - docker start jellyseerr >/dev/null 2>&1 || true - fi + local status=$? + trap - EXIT + rm -rf -- "$TEMP_DIR" + if ((status != 0)); then + printf '%b[ERROR]%b Installation failed.\n' "$RED" "$NC" >&2 + if $DEPLOYMENT_STARTED && ! $DEPLOYMENT_FINISHED && [[ -n "$ROLLBACK_ARCHIVE" && -s "$ROLLBACK_ARCHIVE" ]]; then + log_warn "Restoring previous generated configuration" + rm -f "$INSTALL_DIR/.env" "$INSTALL_DIR/compose.yaml" "$INSTALL_DIR/compose.openvpn.yaml" "$INSTALL_DIR/compose.wireguard.yaml" "$INSTALL_DIR/compose.gpu.yaml" \ + "$INSTALL_DIR/update_stack.sh" "$INSTALL_DIR/sync_transmission_port.sh" "$INSTALL_DIR/media_stack.sh" "$INSTALL_DIR/important_info.md" + rm -rf -- "$INSTALL_DIR/secrets" + tar -xzf "$ROLLBACK_ARCHIVE" -C "$INSTALL_DIR" || true + (cd "$INSTALL_DIR" && docker compose up -d --remove-orphans) || true fi - exit "$status" + fi + exit "$status" } trap cleanup EXIT trap 'printf "%b[ERROR]%b Failure at line %s.\n" "$RED" "$NC" "$LINENO" >&2' ERR -log_info "Installing prerequisites inside the LXC..." +log_info "Installing prerequisites..." export DEBIAN_FRONTEND=noninteractive apt-get update -apt-get install -y -q ca-certificates curl findutils gnupg iproute2 jq openssl tar unattended-upgrades util-linux - -cat > /etc/apt/apt.conf.d/20auto-upgrades <<'EOF' +apt-get install -y -q ca-certificates curl findutils gnupg iproute2 jq openssl python3-yaml tar unattended-upgrades util-linux +cat >/etc/apt/apt.conf.d/20auto-upgrades <<'APT' APT::Periodic::Update-Package-Lists "1"; APT::Periodic::Unattended-Upgrade "1"; -EOF +APT systemctl enable --now unattended-upgrades.service >/dev/null install_docker() { - log_info "Installing Docker Engine from Docker's signed APT repository..." - conflicting_packages=() - for package in docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc; do - dpkg-query -W -f='${db:Status-Abbrev}' "$package" 2>/dev/null | grep -q '^ii' && conflicting_packages+=("$package") - done - if ((${#conflicting_packages[@]} > 0)); then - log_warn "Replacing conflicting distribution packages with Docker CE: ${conflicting_packages[*]}" - apt-get remove -y "${conflicting_packages[@]}" - fi - install -m 0755 -d /etc/apt/keyrings - curl --fail --silent --show-error --location --retry 3 \ - "https://download.docker.com/linux/${ID}/gpg" -o /etc/apt/keyrings/docker.asc - chmod 0644 /etc/apt/keyrings/docker.asc - cat > /etc/apt/sources.list.d/docker.sources </dev/null | grep -q '^ii' && conflicting+=("$package") + done + ((${#conflicting[@]}==0)) || apt-get remove -y "${conflicting[@]}" + install -m 0755 -d /etc/apt/keyrings + curl --fail --silent --show-error --location --retry 3 "https://download.docker.com/linux/${ID}/gpg" -o /etc/apt/keyrings/docker.asc + chmod 0644 /etc/apt/keyrings/docker.asc + cat >/etc/apt/sources.list.d/docker.sources </dev/null || ! docker compose version >/dev/null 2>&1; then - install_docker -fi +if ! command -v docker >/dev/null || ! docker compose version >/dev/null 2>&1; then install_docker; fi systemctl enable --now docker >/dev/null -docker info >/dev/null 2>&1 || die "The Docker daemon is unavailable." - -log_info "Verifying Docker support inside the container..." -docker run --rm --pull=missing hello-world >/dev/null || - die "Docker cannot start a container. In Proxmox enable nesting and keyctl, then fully stop/start the LXC." +docker info >/dev/null 2>&1 || die "Docker daemon is unavailable" +docker run --rm --pull=missing hello-world >/dev/null || die "Docker cannot start a container; check LXC nesting/keyctl" read_env() { - local key=$1 file=$2 line value - [[ -f "$file" ]] || return 0 - line=$(awk -v key="$key" 'index($0, key "=") == 1 {print; exit}' "$file") - [[ -n "$line" ]] || return 0 - value=${line#*=} - if [[ "$value" == "'"*"'" && ${#value} -ge 2 ]]; then - value=${value:1:${#value}-2} - elif [[ "$value" == '"'*'"' && ${#value} -ge 2 ]]; then - value=${value:1:${#value}-2} - fi - printf '%s' "$value" + local key=$1 file=$2 line value + [[ -f "$file" ]] || return 0 + line=$(awk -v key="$key" 'index($0,key "=")==1 {print; exit}' "$file") + [[ -n "$line" ]] || return 0 + value=${line#*=} + if [[ "$value" == "'"*"'" && ${#value} -ge 2 ]]; then value=${value:1:${#value}-2}; + elif [[ "$value" == '"'*'"' && ${#value} -ge 2 ]]; then value=${value:1:${#value}-2}; fi + printf '%s' "$value" } - prompt_value() { - local variable=$1 label=$2 default=${3:-} answer - if [[ -n "$default" ]]; then - read -r -p "$label [$default]: " answer - printf -v "$variable" '%s' "${answer:-$default}" - else - read -r -p "$label: " answer - printf -v "$variable" '%s' "$answer" - fi + local variable=$1 label=$2 default=${3:-} answer + if [[ -n "$default" ]]; then read -r -p "$label [$default]: " answer; printf -v "$variable" '%s' "${answer:-$default}"; + else read -r -p "$label: " answer; printf -v "$variable" '%s' "$answer"; fi } - prompt_secret() { - local variable=$1 label=$2 current=${3:-} answer - if [[ -n "$current" ]]; then - read -r -s -p "$label [Enter keeps the existing value]: " answer - else - read -r -s -p "$label: " answer - fi - printf '\n' - printf -v "$variable" '%s' "${answer:-$current}" + local variable=$1 label=$2 current=${3:-} answer + if [[ -n "$current" ]]; then read -r -s -p "$label [Enter keeps existing]: " answer; else read -r -s -p "$label: " answer; fi + printf '\n'; printf -v "$variable" '%s' "${answer:-$current}" } - prompt_yes_no() { - local variable=$1 label=$2 default=${3:-yes} answer suffix - if [[ "$default" == yes ]]; then suffix="Y/n"; else suffix="y/N"; fi - read -r -p "$label ($suffix): " answer - case "$answer" in - [Yy]|[Yy][Ee][Ss]) printf -v "$variable" yes ;; - [Nn]|[Nn][Oo]) printf -v "$variable" no ;; - "") printf -v "$variable" '%s' "$default" ;; - *) die "Expected yes or no." ;; - esac -} - -safe_value() { - [[ "$1" != *$'\n'* && "$1" != *$'\r'* && "$1" != *"'"* ]] + local variable=$1 label=$2 default=${3:-yes} answer suffix + [[ "$default" == yes ]] && suffix=Y/n || suffix=y/N + read -r -p "$label ($suffix): " answer + case "$answer" in [Yy]|[Yy][Ee][Ss]) printf -v "$variable" yes ;; [Nn]|[Nn][Oo]) printf -v "$variable" no ;; "") printf -v "$variable" '%s' "$default" ;; *) die "Expected yes or no" ;; esac } - +safe_value() { [[ "$1" != *$'\n'* && "$1" != *$'\r'* && "$1" != *"'"* ]]; } detect_lan_ip() { - local detected - detected=$(ip -4 route get 1.1.1.1 2>/dev/null | awk '{for (i=1; i<=NF; i++) if ($i == "src") {print $(i+1); exit}}') - [[ -n "$detected" ]] || detected=$(hostname -I | awk '{print $1}') - printf '%s' "$detected" + local detected + detected=$(ip -4 route get 1.1.1.1 2>/dev/null | awk '{for(i=1;i<=NF;i++) if($i=="src"){print $(i+1);exit}}') + [[ -n "$detected" ]] || detected=$(hostname -I | awk '{print $1}') + printf '%s' "$detected" } - valid_ipv4() { - local address=$1 octet - local -a octets - IFS=. read -r -a octets <<< "$address" - ((${#octets[@]} == 4)) || return 1 - for octet in "${octets[@]}"; do - if [[ ! "$octet" =~ ^[0-9]{1,3}$ ]] || ((10#$octet > 255)); then - return 1 - fi - done + local address=$1 octet; local -a octets; IFS=. read -r -a octets <<<"$address"; ((${#octets[@]}==4)) || return 1 + for octet in "${octets[@]}"; do [[ "$octet" =~ ^[0-9]{1,3}$ ]] && ((10#$octet<=255)) || return 1; done } printf '%b\n' "$BLUE============================================================$NC" printf '%b\n' "$BLUE MEDIA STACK INSTALLER v${INSTALLER_VERSION}$NC" printf '%b\n\n' "$BLUE============================================================$NC" - prompt_value INSTALL_DIR "Installation path" "$DEFAULT_INSTALL_DIR" -[[ "$INSTALL_DIR" =~ ^/[A-Za-z0-9._/-]+$ ]] || - die "The installation path must be absolute and may contain only letters, digits, /, ., _ and -." -[[ "$INSTALL_DIR" != / && "$INSTALL_DIR" != /opt && "$INSTALL_DIR" != /srv && "$INSTALL_DIR" != /mnt && - "$INSTALL_DIR" != /usr && "$INSTALL_DIR" != /var ]] || die "Choose a dedicated installation directory." -case "$INSTALL_DIR" in - /etc/*|/boot/*|/run/*|/usr/*|/var/lib/docker|/var/lib/docker/*) - die "Choose a data location such as /opt/media-stack, /srv/media-stack or /mnt/media-stack." - ;; -esac - -mkdir -p "$INSTALL_DIR" -mkdir -p "$INSTALL_DIR/.update-state" +[[ "$INSTALL_DIR" =~ ^/[A-Za-z0-9._/-]+$ ]] || die "Installation path contains unsupported characters" +case "$INSTALL_DIR" in /|/opt|/srv|/mnt|/usr|/var|/etc/*|/boot/*|/run/*|/usr/*|/var/lib/docker|/var/lib/docker/*) die "Choose a dedicated data directory" ;; esac +mkdir -p "$INSTALL_DIR/.update-state" "$INSTALL_DIR/backups" exec 9>"$INSTALL_DIR/.update-state/update.lock" -flock -n 9 || die "A Media Stack update or backup is already running in $INSTALL_DIR." +flock -n 9 || die "An update or backup is already running in $INSTALL_DIR" OLD_ENV="$INSTALL_DIR/.env" -CURRENT_LAN_IP=$(read_env LAN_IP "$OLD_ENV") -DETECTED_LAN_IP=$(detect_lan_ip) +CURRENT_LAN_IP=$(read_env LAN_IP "$OLD_ENV"); DETECTED_LAN_IP=$(detect_lan_ip) prompt_value LAN_IP "LAN IPv4 address" "${CURRENT_LAN_IP:-$DETECTED_LAN_IP}" valid_ipv4 "$LAN_IP" || die "Invalid IPv4 address: $LAN_IP" -ip -4 addr show | grep -Fq " $LAN_IP/" || die "$LAN_IP is not currently assigned to this system." +ip -4 addr show | grep -Fq " $LAN_IP/" || die "$LAN_IP is not assigned to this LXC" CURRENT_VPN_TYPE=$(read_env VPN_TYPE "$OLD_ENV") -[[ "$CURRENT_VPN_TYPE" == wireguard || "$CURRENT_VPN_TYPE" == openvpn ]] || CURRENT_VPN_TYPE=openvpn +[[ "$CURRENT_VPN_TYPE" == wireguard || "$CURRENT_VPN_TYPE" == openvpn ]] || CURRENT_VPN_TYPE=wireguard prompt_value VPN_TYPE "ProtonVPN protocol (wireguard/openvpn)" "$CURRENT_VPN_TYPE" -[[ "$VPN_TYPE" == wireguard || "$VPN_TYPE" == openvpn ]] || die "VPN protocol must be wireguard or openvpn." +[[ "$VPN_TYPE" == wireguard || "$VPN_TYPE" == openvpn ]] || die "VPN protocol must be wireguard or openvpn" -LEGACY_VPN_USER=$(read_env VPN_USER "$OLD_ENV") -LEGACY_VPN_PASS=$(read_env VPN_PASS "$OLD_ENV") -CURRENT_OPENVPN_USER="" -CURRENT_OPENVPN_PASSWORD="" -CURRENT_WIREGUARD_KEY="" +CURRENT_OPENVPN_USER=""; CURRENT_OPENVPN_PASSWORD=""; CURRENT_WIREGUARD_KEY="" [[ -f "$INSTALL_DIR/secrets/proton_openvpn_user" ]] && CURRENT_OPENVPN_USER=$(<"$INSTALL_DIR/secrets/proton_openvpn_user") [[ -f "$INSTALL_DIR/secrets/proton_openvpn_password" ]] && CURRENT_OPENVPN_PASSWORD=$(<"$INSTALL_DIR/secrets/proton_openvpn_password") [[ -f "$INSTALL_DIR/secrets/proton_wireguard_private_key" ]] && CURRENT_WIREGUARD_KEY=$(<"$INSTALL_DIR/secrets/proton_wireguard_private_key") -CURRENT_OPENVPN_USER=${CURRENT_OPENVPN_USER:-$LEGACY_VPN_USER} -CURRENT_OPENVPN_PASSWORD=${CURRENT_OPENVPN_PASSWORD:-$LEGACY_VPN_PASS} - -OPENVPN_USER="" -OPENVPN_PASSWORD="" -WIREGUARD_PRIVATE_KEY="" -if [[ "$VPN_TYPE" == openvpn ]]; then - printf '\n--- ProtonVPN / OpenVPN ---\n' - prompt_value OPENVPN_USER "OpenVPN username (the installer adds +pmp)" "${CURRENT_OPENVPN_USER%%+pmp*}" - prompt_secret OPENVPN_PASSWORD "OpenVPN password" "$CURRENT_OPENVPN_PASSWORD" - [[ -n "$OPENVPN_USER" && -n "$OPENVPN_PASSWORD" ]] || die "OpenVPN credentials are required." - [[ "$OPENVPN_USER" != *[[:space:]]* ]] || die "The OpenVPN username cannot contain whitespace." - [[ "$OPENVPN_USER" == *+pmp* ]] || OPENVPN_USER="${OPENVPN_USER}+pmp" +OPENVPN_USER=""; OPENVPN_PASSWORD=""; WIREGUARD_PRIVATE_KEY="" +if [[ "$VPN_TYPE" == wireguard ]]; then + printf '\n--- ProtonVPN / WireGuard (recommended) ---\n' + log_info "Use PrivateKey from a ProtonVPN WireGuard configuration generated with NAT-PMP/port forwarding enabled" + prompt_secret WIREGUARD_PRIVATE_KEY "WireGuard private key" "$CURRENT_WIREGUARD_KEY" + [[ "$WIREGUARD_PRIVATE_KEY" =~ ^[A-Za-z0-9+/]{43}=$ ]] || die "Invalid WireGuard private key" else - printf '\n--- ProtonVPN / WireGuard ---\n' - log_info "Use the PrivateKey from a ProtonVPN WireGuard configuration generated with NAT-PMP enabled." - prompt_secret WIREGUARD_PRIVATE_KEY "WireGuard private key" "$CURRENT_WIREGUARD_KEY" - [[ "$WIREGUARD_PRIVATE_KEY" =~ ^[A-Za-z0-9+/]{43}=$ ]] || die "The WireGuard private key is not valid base64 key material." -fi - -CURRENT_PROFILES=$(read_env COMPOSE_PROFILES "$OLD_ENV") -PANGOLIN_DEFAULT=yes -[[ -f "$OLD_ENV" && ",$CURRENT_PROFILES," != *,pangolin,* ]] && PANGOLIN_DEFAULT=no -prompt_yes_no ENABLE_PANGOLIN "Enable public Jellyfin/Seerr access through Pangolin" "$PANGOLIN_DEFAULT" - -LEGACY_PANGOLIN_ENDPOINT=$(read_env PANGOLIN_ENDPOINT "$OLD_ENV") -LEGACY_NEWT_ID=$(read_env NEWT_ID "$OLD_ENV") -LEGACY_NEWT_SECRET=$(read_env NEWT_SECRET "$OLD_ENV") -CURRENT_PUBLIC_DOMAIN=$(read_env PUBLIC_DOMAIN "$OLD_ENV") -PANGOLIN_ENDPOINT=$LEGACY_PANGOLIN_ENDPOINT -NEWT_ID=$LEGACY_NEWT_ID -NEWT_SECRET=$LEGACY_NEWT_SECRET -if [[ -f "$INSTALL_DIR/config/newt/config.json" ]]; then - JSON_PANGOLIN_ENDPOINT=$(jq -r '.endpoint // empty' "$INSTALL_DIR/config/newt/config.json" 2>/dev/null || true) - JSON_NEWT_ID=$(jq -r '.id // empty' "$INSTALL_DIR/config/newt/config.json" 2>/dev/null || true) - JSON_NEWT_SECRET=$(jq -r '.secret // empty' "$INSTALL_DIR/config/newt/config.json" 2>/dev/null || true) - PANGOLIN_ENDPOINT=${JSON_PANGOLIN_ENDPOINT:-$PANGOLIN_ENDPOINT} - NEWT_ID=${JSON_NEWT_ID:-$NEWT_ID} - NEWT_SECRET=${JSON_NEWT_SECRET:-$NEWT_SECRET} -fi - -PUBLIC_DOMAIN=${CURRENT_PUBLIC_DOMAIN:-disabled.invalid} -if [[ "$ENABLE_PANGOLIN" == yes ]]; then - printf '\n--- Pangolin / Newt ---\n' - prompt_value PANGOLIN_ENDPOINT "Pangolin endpoint" "$PANGOLIN_ENDPOINT" - prompt_value NEWT_ID "Newt ID" "$NEWT_ID" - prompt_secret NEWT_SECRET "Newt secret" "$NEWT_SECRET" - [[ "$PANGOLIN_ENDPOINT" =~ ^https?://[^/[:space:]]+/?$ ]] || die "Use a full Pangolin endpoint URL, for example https://pangolin.example.com." - PANGOLIN_ENDPOINT=${PANGOLIN_ENDPOINT%/} - [[ "$PANGOLIN_ENDPOINT" == https://* ]] || log_warn "The Pangolin endpoint is using plain HTTP. HTTPS is strongly recommended." - [[ -n "$NEWT_ID" && -n "$NEWT_SECRET" ]] || die "Newt ID and secret are required." - PANGOLIN_HOST=${PANGOLIN_ENDPOINT#*://} - DETECTED_DOMAIN=${PANGOLIN_HOST#pangolin.} - [[ "$DETECTED_DOMAIN" != "$PANGOLIN_HOST" ]] || DETECTED_DOMAIN=${PANGOLIN_HOST#*.} - prompt_value PUBLIC_DOMAIN "Public base domain" "${CURRENT_PUBLIC_DOMAIN:-$DETECTED_DOMAIN}" - [[ "$PUBLIC_DOMAIN" =~ ^([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?\.)+[A-Za-z]{2,63}$ ]] || die "Invalid public domain: $PUBLIC_DOMAIN" + printf '\n--- ProtonVPN / OpenVPN fallback ---\n' + prompt_value OPENVPN_USER "OpenVPN username (installer adds +pmp)" "${CURRENT_OPENVPN_USER%%+pmp*}" + prompt_secret OPENVPN_PASSWORD "OpenVPN password" "$CURRENT_OPENVPN_PASSWORD" + [[ -n "$OPENVPN_USER" && -n "$OPENVPN_PASSWORD" ]] || die "OpenVPN credentials are required" + [[ "$OPENVPN_USER" != *[[:space:]]* ]] || die "OpenVPN username cannot contain whitespace" + [[ "$OPENVPN_USER" == *+pmp* ]] || OPENVPN_USER="${OPENVPN_USER}+pmp" fi printf '\n--- Transmission ---\n' -CURRENT_TR_USER=$(read_env TR_USER "$OLD_ENV") -CURRENT_TR_PASS=$(read_env TR_PASS "$OLD_ENV") +CURRENT_TR_USER=""; CURRENT_TR_PASS="" [[ -f "$INSTALL_DIR/secrets/transmission_user" ]] && CURRENT_TR_USER=$(<"$INSTALL_DIR/secrets/transmission_user") [[ -f "$INSTALL_DIR/secrets/transmission_password" ]] && CURRENT_TR_PASS=$(<"$INSTALL_DIR/secrets/transmission_password") prompt_value TR_USER "Transmission username" "${CURRENT_TR_USER:-admin}" GENERATED_TR_PASSWORD=false -if [[ -z "$CURRENT_TR_PASS" ]]; then - RANDOM_PASSWORD_MATERIAL=$(openssl rand -hex 16) - CURRENT_TR_PASS=${RANDOM_PASSWORD_MATERIAL:0:24} - GENERATED_TR_PASSWORD=true -fi +if [[ -z "$CURRENT_TR_PASS" ]]; then CURRENT_TR_PASS=$(openssl rand -hex 16 | cut -c1-24); GENERATED_TR_PASSWORD=true; fi prompt_secret TR_PASS "Transmission password" "$CURRENT_TR_PASS" -[[ -n "$TR_USER" && -n "$TR_PASS" ]] || die "Transmission credentials are required." - -FLARESOLVERR_DEFAULT=yes -[[ -f "$OLD_ENV" && ",$CURRENT_PROFILES," != *,flaresolverr,* ]] && FLARESOLVERR_DEFAULT=no -prompt_yes_no ENABLE_FLARESOLVERR "Enable FlareSolverr" "$FLARESOLVERR_DEFAULT" +[[ -n "$TR_USER" && -n "$TR_PASS" ]] || die "Transmission credentials are required" -TAILSCALE_DEFAULT=$(read_env ENABLE_TAILSCALE "$OLD_ENV") -[[ "$TAILSCALE_DEFAULT" == yes || "$TAILSCALE_DEFAULT" == no ]] || TAILSCALE_DEFAULT=yes -prompt_yes_no ENABLE_TAILSCALE "Enable private remote access through Tailscale" "$TAILSCALE_DEFAULT" +CURRENT_PROFILES=$(read_env COMPOSE_PROFILES "$OLD_ENV") +FLARESOLVERR_DEFAULT=yes; [[ -f "$OLD_ENV" && ",$CURRENT_PROFILES," != *,flaresolverr,* ]] && FLARESOLVERR_DEFAULT=no +prompt_yes_no ENABLE_FLARESOLVERR "Enable optional FlareSolverr" "$FLARESOLVERR_DEFAULT" CURRENT_OFFSITE=$(read_env OFFSITE_BACKUP_DIR "$OLD_ENV") prompt_value OFFSITE_BACKUP_DIR "External backup directory (empty disables it)" "$CURRENT_OFFSITE" -OFFSITE_BACKUP_SOURCE="" -OFFSITE_BACKUP_MOUNTPOINT="" +OFFSITE_BACKUP_SOURCE=""; OFFSITE_BACKUP_MOUNTPOINT="" if [[ -n "$OFFSITE_BACKUP_DIR" ]]; then - [[ "$OFFSITE_BACKUP_DIR" == /* ]] || die "The external backup path must be absolute." - safe_value "$OFFSITE_BACKUP_DIR" || die "The external backup path contains unsupported characters." - [[ -d "$OFFSITE_BACKUP_DIR" && -w "$OFFSITE_BACKUP_DIR" ]] || die "Mount the external backup directory and make it writable first." - read -r OFFSITE_BACKUP_SOURCE OFFSITE_BACKUP_MOUNTPOINT < <(findmnt -T "$OFFSITE_BACKUP_DIR" -n -o SOURCE,TARGET --first) - [[ -n "$OFFSITE_BACKUP_SOURCE" && "$OFFSITE_BACKUP_MOUNTPOINT" != / ]] || - die "The external backup directory must be on a separately mounted filesystem, not the LXC root filesystem." + [[ "$OFFSITE_BACKUP_DIR" == /* ]] || die "External backup path must be absolute" + safe_value "$OFFSITE_BACKUP_DIR" || die "External backup path contains unsupported characters" + [[ -d "$OFFSITE_BACKUP_DIR" && -w "$OFFSITE_BACKUP_DIR" ]] || die "External backup directory must already be mounted and writable" + read -r OFFSITE_BACKUP_SOURCE OFFSITE_BACKUP_MOUNTPOINT < <(findmnt -T "$OFFSITE_BACKUP_DIR" -n -o SOURCE,TARGET --first) + [[ -n "$OFFSITE_BACKUP_SOURCE" && "$OFFSITE_BACKUP_MOUNTPOINT" != / ]] || die "External backup must be on a separately mounted filesystem" fi -GPU_DEFAULT=no -[[ -n "$(read_env RENDER_GID "$OLD_ENV")" ]] && GPU_DEFAULT=yes -ENABLE_GPU=no -RENDER_GID="" +GPU_DEFAULT=no; [[ -n "$(read_env RENDER_GID "$OLD_ENV")" ]] && GPU_DEFAULT=yes +ENABLE_GPU=no; RENDER_GID="" if [[ -e /dev/dri/renderD128 ]]; then - prompt_yes_no ENABLE_GPU "Enable Intel/AMD hardware transcoding for Jellyfin" "$GPU_DEFAULT" - [[ "$ENABLE_GPU" == no ]] || RENDER_GID=$(stat -c '%g' /dev/dri/renderD128) + prompt_yes_no ENABLE_GPU "Enable hardware transcoding for Jellyfin" "$GPU_DEFAULT" + [[ "$ENABLE_GPU" == no ]] || RENDER_GID=$(stat -c '%g' /dev/dri/renderD128) fi -for value in "$LAN_IP" "$OPENVPN_USER" "$OPENVPN_PASSWORD" "$WIREGUARD_PRIVATE_KEY" \ - "$PANGOLIN_ENDPOINT" "$NEWT_ID" "$NEWT_SECRET" "$PUBLIC_DOMAIN" "$TR_USER" "$TR_PASS"; do - safe_value "$value" || die "A value contains an unsupported apostrophe or newline." -done +for value in "$LAN_IP" "$OPENVPN_USER" "$OPENVPN_PASSWORD" "$WIREGUARD_PRIVATE_KEY" "$TR_USER" "$TR_PASS"; do safe_value "$value" || die "A value contains an unsupported apostrophe or newline"; done -if [[ ! -f "$INSTALL_DIR/compose.yaml" && ! -f "$INSTALL_DIR/docker-compose.yml" ]]; then - log_info "Checking service ports on $LAN_IP..." - for port in 5055 6767 7878 8096 8989 9091 9696; do - if ss -H -ltn "sport = :$port" | grep -q .; then - die "TCP port $port is already in use." - fi - done +if [[ ! -f "$INSTALL_DIR/compose.yaml" ]]; then + log_info "Checking service ports on $LAN_IP..." + for port in 5055 6767 7878 8096 8989 9091 9696; do ss -H -ltn "sport = :$port" | grep -q . && die "TCP port $port is already in use"; done fi REAL_USER=${SUDO_USER:-} if [[ -z "$REAL_USER" || "$REAL_USER" == root ]]; then - if id media >/dev/null 2>&1; then - REAL_USER=media - elif getent passwd 1000 >/dev/null; then - REAL_USER=$(getent passwd 1000 | cut -d: -f1) - else - useradd --create-home --user-group --shell /usr/sbin/nologin media - REAL_USER=media - fi + if id media >/dev/null 2>&1; then REAL_USER=media + elif getent passwd 1000 >/dev/null; then REAL_USER=$(getent passwd 1000 | cut -d: -f1) + else useradd --create-home --user-group --shell /usr/sbin/nologin media; REAL_USER=media; fi fi -PUID=$(id -u "$REAL_USER") -PGID=$(id -g "$REAL_USER") -TZ=$(cat /etc/timezone 2>/dev/null || printf 'Etc/UTC') - -log_info "Preparing persistent directories without recursively changing existing media ownership..." -DIRS=( - config/gluetun config/transmission config/sonarr config/radarr config/prowlarr - config/bazarr config/jellyfin config/seerr config/newt - data/torrents/movies data/torrents/tv data/torrents/incomplete - data/media/movies data/media/tv backups .update-state secrets -) -for relative_dir in "${DIRS[@]}"; do - mkdir -p "$INSTALL_DIR/$relative_dir" -done -for relative_dir in config/gluetun config/transmission config/sonarr config/radarr config/prowlarr config/bazarr config/jellyfin \ - data data/torrents data/torrents/movies data/torrents/tv data/torrents/incomplete data/media data/media/movies data/media/tv; do - chown "$PUID:$PGID" "$INSTALL_DIR/$relative_dir" 2>/dev/null || - die "Cannot assign $INSTALL_DIR/$relative_dir to UID:GID $PUID:$PGID. Fix the Proxmox bind-mount ID mapping." - chmod 0775 "$INSTALL_DIR/$relative_dir" +PUID=$(id -u "$REAL_USER"); PGID=$(id -g "$REAL_USER"); TZ=$(cat /etc/timezone 2>/dev/null || printf 'Etc/UTC') + +DIRS=(config/gluetun/auth config/transmission config/sonarr config/radarr config/prowlarr config/bazarr config/jellyfin config/seerr data/torrents/movies data/torrents/tv data/torrents/incomplete data/media/movies data/media/tv backups .update-state secrets) +for d in "${DIRS[@]}"; do mkdir -p "$INSTALL_DIR/$d"; done +for d in config/gluetun config/transmission config/sonarr config/radarr config/prowlarr config/bazarr config/jellyfin data data/torrents data/torrents/movies data/torrents/tv data/torrents/incomplete data/media data/media/movies data/media/tv; do + chown "$PUID:$PGID" "$INSTALL_DIR/$d" 2>/dev/null || die "Cannot assign $INSTALL_DIR/$d to UID:GID $PUID:$PGID; fix bind-mount mapping" + chmod 0775 "$INSTALL_DIR/$d" done -chown 1000:1000 "$INSTALL_DIR/config/seerr" 2>/dev/null || - die "Cannot assign the Seerr config directory to UID:GID 1000:1000. Fix the bind-mount ID mapping." +chown 1000:1000 "$INSTALL_DIR/config/seerr" 2>/dev/null || die "Cannot assign Seerr config to UID:GID 1000:1000" chmod 0750 "$INSTALL_DIR/config" "$INSTALL_DIR/secrets" "$INSTALL_DIR/.update-state" PERMISSION_TEST="$INSTALL_DIR/data/.media-stack-write-test" -if ! runuser -u "$REAL_USER" -- touch "$PERMISSION_TEST"; then - die "UID $PUID cannot write to $INSTALL_DIR/data. Fix storage ownership or the LXC UID/GID mapping." -fi +runuser -u "$REAL_USER" -- touch "$PERMISSION_TEST" || die "UID $PUID cannot write to $INSTALL_DIR/data" rm -f "$PERMISSION_TEST" - -HARDLINK_SOURCE="$INSTALL_DIR/data/torrents/.hardlink-test" -HARDLINK_TARGET="$INSTALL_DIR/data/media/.hardlink-test" +HARDLINK_SOURCE="$INSTALL_DIR/data/torrents/.hardlink-test"; HARDLINK_TARGET="$INSTALL_DIR/data/media/.hardlink-test" runuser -u "$REAL_USER" -- touch "$HARDLINK_SOURCE" -if ! runuser -u "$REAL_USER" -- ln "$HARDLINK_SOURCE" "$HARDLINK_TARGET" 2>/dev/null; then - log_warn "The data filesystem does not support hardlinks across torrents and media; imports will copy instead." -fi +runuser -u "$REAL_USER" -- ln "$HARDLINK_SOURCE" "$HARDLINK_TARGET" || { rm -f "$HARDLINK_SOURCE" "$HARDLINK_TARGET"; die "Hardlinks do not work between torrents and media; keep them on one filesystem"; } rm -f "$HARDLINK_SOURCE" "$HARDLINK_TARGET" -if [[ -d "$INSTALL_DIR/config/jellyseerr" && ! -e "$INSTALL_DIR/config/seerr/settings.json" ]] && - docker container inspect jellyseerr >/dev/null 2>&1; then - if [[ "$(docker inspect --format '{{.State.Running}}' jellyseerr)" == true ]]; then - log_info "Stopping the legacy Jellyseerr container for a consistent migration..." - docker stop jellyseerr >/dev/null - JELLYSEERR_WAS_RUNNING=true - fi -fi -if [[ -d "$INSTALL_DIR/config/jellyseerr" && ! -e "$INSTALL_DIR/config/seerr/settings.json" ]]; then - tar -czf "$INSTALL_DIR/backups/jellyseerr-before-seerr-$(date +%Y%m%d-%H%M%S).tar.gz" \ - -C "$INSTALL_DIR" config/jellyseerr - cp -a "$INSTALL_DIR/config/jellyseerr/." "$INSTALL_DIR/config/seerr/" - chown -R 1000:1000 "$INSTALL_DIR/config/seerr" - JELLYSEERR_MIGRATED=true -fi - -if [[ ! -f "$INSTALL_DIR/config/transmission/settings.json" ]]; then - cat > "$INSTALL_DIR/config/transmission/settings.json" <<'EOF' -{ - "download-dir": "/data/torrents", - "incomplete-dir": "/data/torrents/incomplete", - "incomplete-dir-enabled": true, - "peer-port-random-on-start": false, - "port-forwarding-enabled": false, - "rename-partial-files": true -} -EOF - chown "$PUID:$PGID" "$INSTALL_DIR/config/transmission/settings.json" - chmod 0640 "$INSTALL_DIR/config/transmission/settings.json" -fi - -acquire_bundle() { - local script_dir archive ref - script_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd) - if [[ -f "$script_dir/templates/compose.yaml" && -f "$script_dir/update_stack.sh" && -f "$script_dir/media_stack.sh" ]]; then - printf '%s' "$script_dir" - return - fi - ref=${MEDIA_STACK_REF:-main} - [[ "$ref" =~ ^[A-Za-z0-9._/-]+$ ]] || die "MEDIA_STACK_REF contains unsupported characters." - archive="$TEMP_DIR/media-stack.tar.gz" - log_info "Downloading one consistent project snapshot (${PROJECT_REPOSITORY}@${ref})..." >&2 - curl --fail --silent --show-error --location --retry 3 \ - "https://github.com/${PROJECT_REPOSITORY}/archive/${ref}.tar.gz" -o "$archive" - mkdir -p "$TEMP_DIR/bundle" - tar -xzf "$archive" --strip-components=1 -C "$TEMP_DIR/bundle" - printf '%s' "$TEMP_DIR/bundle" -} - -BUNDLE_DIR=$(acquire_bundle) -REQUIRED_FILES=( - templates/compose.yaml templates/compose.openvpn.yaml templates/compose.wireguard.yaml templates/compose.gpu.yaml - update_stack.sh sync_transmission_port.sh media_stack.sh -) -for required_file in "${REQUIRED_FILES[@]}"; do - [[ -f "$BUNDLE_DIR/$required_file" ]] || die "The project snapshot is missing $required_file." -done -bash -n "$BUNDLE_DIR/update_stack.sh" "$BUNDLE_DIR/sync_transmission_port.sh" "$BUNDLE_DIR/media_stack.sh" - -STAGE_DIR="$TEMP_DIR/stage" -mkdir -p "$STAGE_DIR/secrets" "$STAGE_DIR/config/newt" -cp "$BUNDLE_DIR/templates/"*.yaml "$STAGE_DIR/" -cp "$BUNDLE_DIR/update_stack.sh" "$BUNDLE_DIR/sync_transmission_port.sh" "$BUNDLE_DIR/media_stack.sh" "$STAGE_DIR/" - -printf '%s' "$TR_USER" > "$STAGE_DIR/secrets/transmission_user" -printf '%s' "$TR_PASS" > "$STAGE_DIR/secrets/transmission_password" -if [[ "$VPN_TYPE" == openvpn ]]; then - printf '%s' "$OPENVPN_USER" > "$STAGE_DIR/secrets/proton_openvpn_user" - printf '%s' "$OPENVPN_PASSWORD" > "$STAGE_DIR/secrets/proton_openvpn_password" -else - printf '%s' "$WIREGUARD_PRIVATE_KEY" > "$STAGE_DIR/secrets/proton_wireguard_private_key" +# Obtain one consistent source snapshot. proxmox_lxc.sh provides it locally; a direct install downloads it. +SOURCE_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd) +if [[ ! -f "$SOURCE_DIR/templates/compose.yaml" || ! -f "$SOURCE_DIR/media_stack.sh" ]]; then + log_info "Downloading a consistent media-stack source snapshot..." + curl --fail --silent --show-error --location --retry 3 "https://github.com/${PROJECT_REPOSITORY}/archive/main.tar.gz" -o "$TEMP_DIR/source.tar.gz" + mkdir -p "$TEMP_DIR/source" + tar -xzf "$TEMP_DIR/source.tar.gz" --strip-components=1 -C "$TEMP_DIR/source" + SOURCE_DIR="$TEMP_DIR/source" fi +for required in templates/compose.yaml templates/compose.wireguard.yaml templates/compose.openvpn.yaml templates/compose.gpu.yaml media_stack.sh update_stack.sh sync_transmission_port.sh; do [[ -f "$SOURCE_DIR/$required" ]] || die "Source snapshot is missing $required"; done + +STAGE_DIR="$TEMP_DIR/stage"; mkdir -p "$STAGE_DIR/secrets" "$STAGE_DIR/config/gluetun/auth" +cp "$SOURCE_DIR/templates/compose.yaml" "$STAGE_DIR/compose.yaml" +cp "$SOURCE_DIR/templates/compose.wireguard.yaml" "$STAGE_DIR/compose.wireguard.yaml" +cp "$SOURCE_DIR/templates/compose.openvpn.yaml" "$STAGE_DIR/compose.openvpn.yaml" +cp "$SOURCE_DIR/templates/compose.gpu.yaml" "$STAGE_DIR/compose.gpu.yaml" +cp "$SOURCE_DIR/media_stack.sh" "$SOURCE_DIR/update_stack.sh" "$SOURCE_DIR/sync_transmission_port.sh" "$STAGE_DIR/" +printf '%s' "$TR_USER" >"$STAGE_DIR/secrets/transmission_user"; printf '%s' "$TR_PASS" >"$STAGE_DIR/secrets/transmission_password" +if [[ "$VPN_TYPE" == wireguard ]]; then printf '%s' "$WIREGUARD_PRIVATE_KEY" >"$STAGE_DIR/secrets/proton_wireguard_private_key"; else printf '%s' "$OPENVPN_USER" >"$STAGE_DIR/secrets/proton_openvpn_user"; printf '%s' "$OPENVPN_PASSWORD" >"$STAGE_DIR/secrets/proton_openvpn_password"; fi chmod 0600 "$STAGE_DIR/secrets/"* - -if [[ "$ENABLE_PANGOLIN" == yes ]]; then - jq -n --arg id "$NEWT_ID" --arg secret "$NEWT_SECRET" --arg endpoint "$PANGOLIN_ENDPOINT" \ - '{id:$id, secret:$secret, endpoint:$endpoint, tlsClientCert:""}' > "$STAGE_DIR/config/newt/config.json" -elif [[ -s "$INSTALL_DIR/config/newt/config.json" ]]; then - cp "$INSTALL_DIR/config/newt/config.json" "$STAGE_DIR/config/newt/config.json" -else - printf '{}\n' > "$STAGE_DIR/config/newt/config.json" -fi -chmod 0600 "$STAGE_DIR/config/newt/config.json" - -COMPOSE_PROFILES=() -[[ "$ENABLE_PANGOLIN" == yes ]] && COMPOSE_PROFILES+=(pangolin) -[[ "$ENABLE_FLARESOLVERR" == yes ]] && COMPOSE_PROFILES+=(flaresolverr) +cat >"$STAGE_DIR/config/gluetun/auth/config.toml" <<'GLUETUN_AUTH' +[[roles]] +name = "media-stack-readonly" +routes = ["GET /v1/portforward", "GET /v1/publicip/ip", "GET /v1/vpn/status"] +auth = "none" +GLUETUN_AUTH +chmod 0640 "$STAGE_DIR/config/gluetun/auth/config.toml" + +COMPOSE_PROFILES=(); [[ "$ENABLE_FLARESOLVERR" == yes ]] && COMPOSE_PROFILES+=(flaresolverr) PROFILE_LIST=$(IFS=,; printf '%s' "${COMPOSE_PROFILES[*]}") -COMPOSE_FILES="compose.yaml:compose.${VPN_TYPE}.yaml" -[[ "$ENABLE_GPU" == yes ]] && COMPOSE_FILES="${COMPOSE_FILES}:compose.gpu.yaml" - -write_env_line() { - printf "%s='%s'\n" "$1" "$2" -} +COMPOSE_FILES="compose.yaml:compose.${VPN_TYPE}.yaml"; [[ "$ENABLE_GPU" == yes ]] && COMPOSE_FILES="${COMPOSE_FILES}:compose.gpu.yaml" +write_env_line() { printf "%s='%s'\n" "$1" "$2"; } { - write_env_line PUID "$PUID" - write_env_line PGID "$PGID" - write_env_line TZ "$TZ" - write_env_line LAN_IP "$LAN_IP" - write_env_line PUBLIC_DOMAIN "$PUBLIC_DOMAIN" - write_env_line VPN_TYPE "$VPN_TYPE" - write_env_line COMPOSE_FILE "$COMPOSE_FILES" - write_env_line COMPOSE_PROFILES "$PROFILE_LIST" - write_env_line ENABLE_TAILSCALE "$ENABLE_TAILSCALE" - write_env_line RENDER_GID "$RENDER_GID" - write_env_line UPDATE_DELAY_DAYS "7" - write_env_line OFFSITE_BACKUP_DIR "$OFFSITE_BACKUP_DIR" - write_env_line OFFSITE_BACKUP_SOURCE "$OFFSITE_BACKUP_SOURCE" - write_env_line OFFSITE_BACKUP_MOUNTPOINT "$OFFSITE_BACKUP_MOUNTPOINT" -} > "$STAGE_DIR/.env" + write_env_line PUID "$PUID"; write_env_line PGID "$PGID"; write_env_line TZ "$TZ"; write_env_line LAN_IP "$LAN_IP" + write_env_line VPN_TYPE "$VPN_TYPE"; write_env_line COMPOSE_FILE "$COMPOSE_FILES"; write_env_line COMPOSE_PROFILES "$PROFILE_LIST" + write_env_line RENDER_GID "$RENDER_GID"; write_env_line UPDATE_DELAY_DAYS "7" + write_env_line OFFSITE_BACKUP_DIR "$OFFSITE_BACKUP_DIR"; write_env_line OFFSITE_BACKUP_SOURCE "$OFFSITE_BACKUP_SOURCE"; write_env_line OFFSITE_BACKUP_MOUNTPOINT "$OFFSITE_BACKUP_MOUNTPOINT" +} >"$STAGE_DIR/.env" chmod 0600 "$STAGE_DIR/.env" -log_info "Validating the exact Compose model before changing the running stack..." -( - cd "$STAGE_DIR" || exit 1 - docker compose config --quiet - mapfile -t declared_services < <(docker compose config --services) - [[ " ${declared_services[*]} " == *" gluetun "* && " ${declared_services[*]} " == *" transmission "* ]] || exit 1 -) - -if [[ -f "$INSTALL_DIR/.env" || -f "$INSTALL_DIR/compose.yaml" || -f "$INSTALL_DIR/docker-compose.yml" ]]; then - timestamp=$(date +%Y%m%d-%H%M%S) - ROLLBACK_ARCHIVE="$INSTALL_DIR/backups/installer-before-${timestamp}.tar.gz" - old_items=() - for item in .env compose.yaml compose.openvpn.yaml compose.wireguard.yaml compose.gpu.yaml docker-compose.yml \ - update_stack.sh sync_transmission_port.sh media_stack.sh important_info.md secrets config/newt/config.json; do - [[ -e "$INSTALL_DIR/$item" ]] && old_items+=("$item") - done - if ((${#old_items[@]} > 0)); then - tar -czf "$ROLLBACK_ARCHIVE" -C "$INSTALL_DIR" "${old_items[@]}" - tar -tzf "$ROLLBACK_ARCHIVE" >/dev/null - fi +log_info "Validating generated Compose configuration..." +(cd "$STAGE_DIR" && docker compose config --quiet && mapfile -t services < <(docker compose config --services) && [[ " ${services[*]} " == *" gluetun "* && " ${services[*]} " == *" transmission "* && " ${services[*]} " == *" bazarr "* ]]) + +if [[ -f "$INSTALL_DIR/.env" || -f "$INSTALL_DIR/compose.yaml" ]]; then + timestamp=$(date +%Y%m%d-%H%M%S); ROLLBACK_ARCHIVE="$INSTALL_DIR/backups/installer-before-${timestamp}.tar.gz" + old_items=(); for item in .env compose.yaml compose.openvpn.yaml compose.wireguard.yaml compose.gpu.yaml update_stack.sh sync_transmission_port.sh media_stack.sh important_info.md secrets config/gluetun/auth/config.toml; do [[ -e "$INSTALL_DIR/$item" ]] && old_items+=("$item"); done + ((${#old_items[@]}==0)) || { tar -czf "$ROLLBACK_ARCHIVE" -C "$INSTALL_DIR" "${old_items[@]}"; tar -tzf "$ROLLBACK_ARCHIVE" >/dev/null; } fi DEPLOYMENT_STARTED=true install -m 0600 "$STAGE_DIR/.env" "$INSTALL_DIR/.env" -install -m 0640 "$STAGE_DIR/compose.yaml" "$STAGE_DIR/compose.openvpn.yaml" \ - "$STAGE_DIR/compose.wireguard.yaml" "$STAGE_DIR/compose.gpu.yaml" "$INSTALL_DIR/" +install -m 0640 "$STAGE_DIR/compose.yaml" "$STAGE_DIR/compose.openvpn.yaml" "$STAGE_DIR/compose.wireguard.yaml" "$STAGE_DIR/compose.gpu.yaml" "$INSTALL_DIR/" install -m 0750 "$STAGE_DIR/update_stack.sh" "$STAGE_DIR/sync_transmission_port.sh" "$STAGE_DIR/media_stack.sh" "$INSTALL_DIR/" -install -m 0600 "$STAGE_DIR/secrets/"* "$INSTALL_DIR/secrets/" -if [[ "$VPN_TYPE" == openvpn ]]; then - rm -f "$INSTALL_DIR/secrets/proton_wireguard_private_key" -else - rm -f "$INSTALL_DIR/secrets/proton_openvpn_user" "$INSTALL_DIR/secrets/proton_openvpn_password" -fi -install -m 0600 "$STAGE_DIR/config/newt/config.json" "$INSTALL_DIR/config/newt/config.json" -rm -f "$INSTALL_DIR/docker-compose.yml" - -if [[ "$ENABLE_TAILSCALE" == yes ]]; then - if ! command -v tailscale >/dev/null; then - log_info "Installing Tailscale from its signed APT repository..." - install -m 0755 -d /usr/share/keyrings - curl --fail --silent --show-error --location --retry 3 \ - "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.noarmor.gpg" \ - -o /usr/share/keyrings/tailscale-archive-keyring.gpg - curl --fail --silent --show-error --location --retry 3 \ - "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.tailscale-keyring.list" \ - -o /etc/apt/sources.list.d/tailscale.list - apt-get update - apt-get install -y -q tailscale - fi - systemctl enable --now tailscaled >/dev/null - if [[ -z "$(tailscale ip -4 2>/dev/null | head -n1)" ]]; then - log_info "Authenticate Tailscale using the URL displayed below." - tailscale up --timeout=10m - fi - [[ -n "$(tailscale ip -4 2>/dev/null | head -n1)" ]] || die "Tailscale did not connect." -fi +rm -rf "$INSTALL_DIR/secrets"; install -d -m 0750 "$INSTALL_DIR/secrets"; install -m 0600 "$STAGE_DIR/secrets/"* "$INSTALL_DIR/secrets/" +install -d -m 0750 "$INSTALL_DIR/config/gluetun/auth"; install -m 0640 "$STAGE_DIR/config/gluetun/auth/config.toml" "$INSTALL_DIR/config/gluetun/auth/config.toml" -log_info "Pulling images and starting the stack (this can take several minutes)..." -( - cd "$INSTALL_DIR" || exit 1 - docker compose config --quiet - docker compose pull - docker compose up -d --remove-orphans --wait --wait-timeout 420 -) - -if $JELLYSEERR_MIGRATED && docker container inspect jellyseerr >/dev/null 2>&1; then - docker rm jellyseerr >/dev/null - JELLYSEERR_WAS_RUNNING=false -fi - -if [[ "$ENABLE_TAILSCALE" == yes ]]; then - log_info "Configuring private HTTPS endpoints with Tailscale Serve..." - for port in 5055 6767 7878 8096 8989 9091 9696; do - tailscale serve --bg --https="$port" "http://127.0.0.1:$port" >/dev/null || - log_warn "Tailscale Serve could not configure HTTPS port $port; retry with: media-stack repair-ip" - done -fi +log_info "Pulling images and starting the stack..." +(cd "$INSTALL_DIR" && docker compose config --quiet && docker compose pull && docker compose up -d --remove-orphans --wait --wait-timeout 420) -cat > /etc/systemd/system/media-stack-update.service </etc/systemd/system/media-stack-update.service < /etc/systemd/system/media-stack-update.timer <<'EOF' +UNIT +cat >/etc/systemd/system/media-stack-update.timer <<'UNIT' [Unit] Description=Nightly Media Stack update check @@ -668,11 +356,10 @@ Persistent=true [Install] WantedBy=timers.target -EOF - -cat > /etc/systemd/system/media-stack-port-sync.service </etc/systemd/system/media-stack-port-sync.service < /etc/systemd/system/media-stack-port-sync.timer <<'EOF' +UNIT +cat >/etc/systemd/system/media-stack-port-sync.timer <<'UNIT' [Unit] Description=Periodic Transmission port synchronization @@ -700,13 +386,12 @@ Persistent=true [Install] WantedBy=timers.target -EOF - +UNIT systemctl daemon-reload systemctl enable --now media-stack-update.timer media-stack-port-sync.timer >/dev/null ln -sfn "$INSTALL_DIR/media_stack.sh" /usr/local/sbin/media-stack -cat > "$INSTALL_DIR/important_info.md" <"$INSTALL_DIR/important_info.md" <> "$INSTALL_DIR/important_info.md" <&2; } @@ -20,514 +18,460 @@ fail() { printf '%b[FAIL]%b %s\n' "$RED" "$NC" "$*" >&2; } die() { fail "$*"; exit 1; } usage() { - cat <<'EOF' + cat <<'USAGE' Media Stack management tool Usage: media-stack COMMAND [ARGUMENT] Commands: - status Show containers, addresses and timers. - doctor Run end-to-end checks, including VPN leak isolation. - configure [--quiet] Idempotently wire Radarr/Sonarr/Prowlarr/Transmission. - repair-ip Detect a changed LAN IP and recreate port bindings. - backup Create a consistent stopped-stack configuration backup. - logs SERVICE Follow logs for one declared Compose service. - version Print the installed tool version. - help Show this help. -EOF + status Show containers, LAN addresses and timers + doctor Run end-to-end health, VPN, storage and GPU checks + configure [--quiet] Idempotently wire the *Arr stack and Bazarr + repair-ip Detect a changed LAN IP and recreate port bindings + backup Create a consistent stopped-stack configuration backup + logs SERVICE Follow logs for one declared Compose service + version Print installed tool version + help Show this help +USAGE } -# Help and version must also work from a source checkout, before installation -# has created the runtime environment file. case "${1:-help}" in - help|-h|--help) - (($# <= 1)) || die "help takes no arguments." - usage - exit 0 - ;; - version) - (($# == 1)) || die "version takes no arguments." - printf 'media-stack %s\n' "$TOOL_VERSION" - exit 0 - ;; + help|-h|--help) (($# <= 1)) || die "help takes no arguments"; usage; exit 0 ;; + version) (($# == 1)) || die "version takes no arguments"; printf 'media-stack %s\n' "$TOOL_VERSION"; exit 0 ;; esac [[ -f "$ENV_FILE" ]] || die "Missing $ENV_FILE. Run the installer first." read_env() { - local key=$1 line value - line=$(awk -v key="$key" 'index($0, key "=") == 1 {print; exit}' "$ENV_FILE") - [[ -n "$line" ]] || return 0 - value=${line#*=} - if [[ "$value" == "'"*"'" && ${#value} -ge 2 ]]; then - value=${value:1:${#value}-2} - elif [[ "$value" == '"'*'"' && ${#value} -ge 2 ]]; then - value=${value:1:${#value}-2} - fi - printf '%s' "$value" + local key=$1 line value + line=$(awk -v key="$key" 'index($0, key "=") == 1 {print; exit}' "$ENV_FILE") + [[ -n "$line" ]] || return 0 + value=${line#*=} + if [[ "$value" == "'"*"'" && ${#value} -ge 2 ]]; then + value=${value:1:${#value}-2} + elif [[ "$value" == '"'*'"' && ${#value} -ge 2 ]]; then + value=${value:1:${#value}-2} + fi + printf '%s' "$value" } write_env() { - local key=$1 value=$2 temp line - [[ "$value" != *"'"* && "$value" != *$'\n'* ]] || die "Unsupported value for $key." - temp=$(mktemp "$STACK_DIR/.env.XXXXXX") - line="$key='$value'" - awk -v key="$key" -v replacement="$line" ' - BEGIN { done = 0 } - index($0, key "=") == 1 { - if (!done) print replacement - done = 1 - next - } - { print } - END { if (!done) print replacement } - ' "$ENV_FILE" > "$temp" - chmod 0600 "$temp" - mv -f "$temp" "$ENV_FILE" + local key=$1 value=$2 temp line + [[ "$value" != *"'"* && "$value" != *$'\n'* ]] || die "Unsupported value for $key" + temp=$(mktemp "$STACK_DIR/.env.XXXXXX") + line="$key='$value'" + awk -v key="$key" -v replacement="$line" ' + BEGIN {done=0} + index($0,key "=")==1 {if(!done) print replacement; done=1; next} + {print} + END {if(!done) print replacement} + ' "$ENV_FILE" >"$temp" + chmod 0600 "$temp" + mv -f "$temp" "$ENV_FILE" } -compose() { - (cd "$STACK_DIR" && docker compose "$@") -} +compose() { (cd "$STACK_DIR" && docker compose "$@"); } detect_lan_ip() { - local detected - detected=$(ip -4 route get 1.1.1.1 2>/dev/null | awk '{for (i=1; i<=NF; i++) if ($i == "src") {print $(i+1); exit}}') - [[ -n "$detected" ]] || detected=$(hostname -I | awk '{print $1}') - printf '%s' "$detected" + local detected + detected=$(ip -4 route get 1.1.1.1 2>/dev/null | awk '{for(i=1;i<=NF;i++) if($i=="src"){print $(i+1); exit}}') + [[ -n "$detected" ]] || detected=$(hostname -I | awk '{print $1}') + printf '%s' "$detected" } has_profile() { - local profiles - profiles=$(read_env COMPOSE_PROFILES) - [[ ",$profiles," == *",$1,"* ]] + local profiles + profiles=$(read_env COMPOSE_PROFILES) + [[ ",$profiles," == *",$1,"* ]] } -command_status() { - local lan_ip public_domain - lan_ip=$(read_env LAN_IP) - public_domain=$(read_env PUBLIC_DOMAIN) - compose ps - printf '\nLAN endpoints (%s):\n' "$lan_ip" - printf ' Jellyfin http://%s:8096\n' "$lan_ip" - printf ' Seerr http://%s:5055\n' "$lan_ip" - printf ' Transmission http://%s:9091\n' "$lan_ip" - printf ' Radarr http://%s:7878\n' "$lan_ip" - printf ' Sonarr http://%s:8989\n' "$lan_ip" - printf ' Prowlarr http://%s:9696\n' "$lan_ip" - printf ' Bazarr http://%s:6767\n' "$lan_ip" - if has_profile pangolin; then - printf '\nPublic through Pangolin:\n https://jellyfin.%s\n https://seerr.%s\n' "$public_domain" "$public_domain" - fi - if [[ "$(read_env ENABLE_TAILSCALE)" == yes ]] && command -v tailscale >/dev/null; then - printf '\nTailscale IP: %s\n' "$(tailscale ip -4 2>/dev/null | head -n1 || printf 'disconnected')" +read_forwarded_port() { + local json port + json=$(compose exec -T gluetun wget -qO- -T 5 http://127.0.0.1:8000/v1/portforward 2>/dev/null || true) + if [[ -n "$json" ]]; then + port=$(jq -r '.port // (.ports[0] // empty)' <<<"$json" 2>/dev/null || true) + if [[ "$port" =~ ^[0-9]+$ ]] && ((port >= 1 && port <= 65535)); then + printf '%s' "$port" + return 0 fi - printf '\nTimers:\n' - systemctl list-timers --all media-stack-update.timer media-stack-port-sync.timer --no-pager 2>/dev/null || true + fi + port=$(compose exec -T gluetun cat /tmp/gluetun/forwarded_port 2>/dev/null || true) + port=${port//$'\r'/}; port=${port//$'\n'/} + [[ "$port" =~ ^[0-9]+$ ]] && ((port >= 1 && port <= 65535)) || return 1 + printf '%s' "$port" +} + +command_status() { + local lan_ip + lan_ip=$(read_env LAN_IP) + compose ps + printf '\nLAN endpoints (%s):\n' "$lan_ip" + printf ' Jellyfin http://%s:8096\n' "$lan_ip" + printf ' Seerr http://%s:5055\n' "$lan_ip" + printf ' Transmission http://%s:9091\n' "$lan_ip" + printf ' Radarr http://%s:7878\n' "$lan_ip" + printf ' Sonarr http://%s:8989\n' "$lan_ip" + printf ' Prowlarr http://%s:9696\n' "$lan_ip" + printf ' Bazarr http://%s:6767\n' "$lan_ip" + printf '\nOptional profile: FlareSolverr %s\n' "$(has_profile flaresolverr && printf enabled || printf disabled)" + printf '\nTimers:\n' + systemctl list-timers --all media-stack-update.timer media-stack-port-sync.timer --no-pager 2>/dev/null || true } CHECK_FAILURES=0 CHECK_WARNINGS=0 check_ok() { ok "$*"; } -check_fail() { fail "$*"; CHECK_FAILURES=$((CHECK_FAILURES + 1)); } -check_warn() { warn "$*"; CHECK_WARNINGS=$((CHECK_WARNINGS + 1)); } +check_fail() { fail "$*"; CHECK_FAILURES=$((CHECK_FAILURES+1)); } +check_warn() { warn "$*"; CHECK_WARNINGS=$((CHECK_WARNINGS+1)); } probe_http() { - local name=$1 url=$2 - if curl --fail --silent --show-error --max-time 8 "$url" >/dev/null 2>&1; then - check_ok "$name responds at $url" - else - check_fail "$name does not respond at $url" - fi + local name=$1 url=$2 + if curl --fail --silent --show-error --max-time 8 "$url" >/dev/null 2>&1; then + check_ok "$name responds" + else + check_fail "$name does not respond at $url" + fi } -command_doctor() { - local configured_ip detected_ip puid pgid storage_test hardlink_source hardlink_target - local service container_id status health gluetun_id transmission_id network_mode host_ip vpn_ip - local forwarded_port offsite_dir offsite_source offsite_mount current_source current_target unit tailscale_ip - CHECK_FAILURES=0 - CHECK_WARNINGS=0 - - [[ $EUID -eq 0 ]] || check_warn "Run as root for complete storage and systemd checks." - if [[ -c /dev/net/tun && -r /dev/net/tun && -w /dev/net/tun ]]; then - check_ok "/dev/net/tun is usable" - else - check_fail "/dev/net/tun is not usable" - fi - if docker info >/dev/null 2>&1; then check_ok "Docker daemon is available"; else check_fail "Docker daemon is unavailable"; fi - if compose config --quiet >/dev/null 2>&1; then check_ok "Compose configuration is valid"; else check_fail "Compose configuration is invalid"; fi - - configured_ip=$(read_env LAN_IP) - detected_ip=$(detect_lan_ip) - if [[ "$configured_ip" == "$detected_ip" ]] && ip -4 addr show | grep -Fq " $configured_ip/"; then - check_ok "LAN binding matches the current address ($configured_ip)" - else - check_fail "LAN binding is $configured_ip but the detected address is $detected_ip; run: media-stack repair-ip" - fi +bazarr_api_key() { + local file="$STACK_DIR/config/bazarr/config/config.yaml" + [[ -s "$file" ]] || return 1 + python3 - "$file" <<'PY' +import sys, yaml +try: + data = yaml.safe_load(open(sys.argv[1], encoding='utf-8')) or {} + value = ((data.get('auth') or {}).get('apikey') or '').strip() + if value: + print(value) +except Exception: + pass +PY +} - puid=$(read_env PUID) - pgid=$(read_env PGID) - storage_test="$STACK_DIR/data/.doctor-write-test" - if setpriv --reuid="$puid" --regid="$pgid" --clear-groups touch "$storage_test" 2>/dev/null; then - rm -f "$storage_test" - check_ok "Media UID:GID can write to the data directory" - else - check_fail "Media UID:GID cannot write to $STACK_DIR/data" - fi - hardlink_source="$STACK_DIR/data/torrents/.doctor-hardlink-test" - hardlink_target="$STACK_DIR/data/media/.doctor-hardlink-test" - if setpriv --reuid="$puid" --regid="$pgid" --clear-groups touch "$hardlink_source" 2>/dev/null && - setpriv --reuid="$puid" --regid="$pgid" --clear-groups ln "$hardlink_source" "$hardlink_target" 2>/dev/null; then - check_ok "Hardlinks work across download and media paths" - else - check_warn "Hardlinks do not work; ARR imports will copy data" - fi - rm -f "$hardlink_source" "$hardlink_target" - - while IFS= read -r service; do - container_id=$(compose ps -q "$service" 2>/dev/null || true) - if [[ -z "$container_id" ]]; then - check_fail "$service has no container" - continue - fi - status=$(docker inspect --format '{{.State.Status}}' "$container_id" 2>/dev/null || true) - health=$(docker inspect --format '{{if .State.Health}}{{.State.Health.Status}}{{else}}none{{end}}' "$container_id" 2>/dev/null || true) - if [[ "$status" == running && ("$health" == healthy || "$health" == none) ]]; then - check_ok "$service is running (health: $health)" - else - check_fail "$service state is $status (health: $health)" - fi - done < <(compose config --services 2>/dev/null || true) - - gluetun_id=$(compose ps -q gluetun 2>/dev/null || true) - transmission_id=$(compose ps -q transmission 2>/dev/null || true) - if [[ -n "$gluetun_id" && -n "$transmission_id" ]]; then - network_mode=$(docker inspect --format '{{.HostConfig.NetworkMode}}' "$transmission_id" 2>/dev/null || true) - if [[ "$network_mode" == "container:$gluetun_id" ]]; then - check_ok "Transmission shares Gluetun's network namespace (kill switch enforced)" - else - check_fail "Transmission is not isolated in Gluetun's network namespace" - fi - fi +api_key_from_config() { + local file=$1 + sed -n 's:.*\([^<]*\).*:\1:p' "$file" 2>/dev/null | awk 'NR==1' +} - probe_http Jellyfin http://127.0.0.1:8096/System/Info/Public - probe_http Seerr http://127.0.0.1:5055/api/v1/settings/public - probe_http Radarr http://127.0.0.1:7878/ping - probe_http Sonarr http://127.0.0.1:8989/ping - probe_http Prowlarr http://127.0.0.1:9696/ping - probe_http Bazarr http://127.0.0.1:6767/ - if [[ ! -s "$STACK_DIR/secrets/transmission_user" || ! -s "$STACK_DIR/secrets/transmission_password" ]]; then - check_fail "Transmission credential files are missing" - elif curl --fail --silent --show-error --max-time 8 \ - -u "$(<"$STACK_DIR/secrets/transmission_user"):$(<"$STACK_DIR/secrets/transmission_password")" \ - http://127.0.0.1:9091/transmission/web/ >/dev/null 2>&1; then - check_ok "Transmission responds with the configured credentials" +command_doctor() { + local configured_ip detected_ip puid pgid storage_test hardlink_source hardlink_target + local service container_id status health gluetun_id transmission_id network_mode host_ip vpn_ip + local forwarded_port unit render_gid bazarr_key bazarr_settings + CHECK_FAILURES=0; CHECK_WARNINGS=0 + + [[ $EUID -eq 0 ]] || check_warn "Run as root for complete checks" + [[ -c /dev/net/tun && -r /dev/net/tun && -w /dev/net/tun ]] && check_ok "/dev/net/tun is usable" || check_fail "/dev/net/tun is not usable" + docker info >/dev/null 2>&1 && check_ok "Docker daemon is available" || check_fail "Docker daemon is unavailable" + compose config --quiet >/dev/null 2>&1 && check_ok "Compose configuration is valid" || check_fail "Compose configuration is invalid" + + configured_ip=$(read_env LAN_IP); detected_ip=$(detect_lan_ip) + if [[ "$configured_ip" == "$detected_ip" ]] && ip -4 addr show | grep -Fq " $configured_ip/"; then + check_ok "LAN binding matches $configured_ip" + else + check_fail "LAN binding is $configured_ip but detected address is $detected_ip; run: media-stack repair-ip" + fi + + puid=$(read_env PUID); pgid=$(read_env PGID) + storage_test="$STACK_DIR/data/.doctor-write-test" + if setpriv --reuid="$puid" --regid="$pgid" --clear-groups touch "$storage_test" 2>/dev/null; then + rm -f "$storage_test"; check_ok "Media UID:GID can write to data" + else + check_fail "Media UID:GID cannot write to $STACK_DIR/data" + fi + hardlink_source="$STACK_DIR/data/torrents/.doctor-hardlink-test" + hardlink_target="$STACK_DIR/data/media/.doctor-hardlink-test" + if setpriv --reuid="$puid" --regid="$pgid" --clear-groups touch "$hardlink_source" 2>/dev/null && + setpriv --reuid="$puid" --regid="$pgid" --clear-groups ln "$hardlink_source" "$hardlink_target" 2>/dev/null; then + check_ok "Hardlinks work between downloads and media" + else + check_warn "Hardlinks do not work; *Arr imports will copy data" + fi + rm -f "$hardlink_source" "$hardlink_target" + + while IFS= read -r service; do + container_id=$(compose ps -q "$service" 2>/dev/null || true) + if [[ -z "$container_id" ]]; then check_fail "$service has no container"; continue; fi + status=$(docker inspect --format '{{.State.Status}}' "$container_id" 2>/dev/null || true) + health=$(docker inspect --format '{{if .State.Health}}{{.State.Health.Status}}{{else}}none{{end}}' "$container_id" 2>/dev/null || true) + if [[ "$status" == running && ("$health" == healthy || "$health" == none) ]]; then + check_ok "$service is running (health: $health)" else - check_fail "Transmission does not accept the configured credentials" + check_fail "$service state is $status (health: $health)" fi - - host_ip=$(curl --fail --silent --show-error --max-time 10 https://api.ipify.org 2>/dev/null || true) - vpn_ip=$(compose exec -T gluetun wget -qO- -T 10 https://api.ipify.org 2>/dev/null || true) - host_ip=${host_ip//$'\n'/} - vpn_ip=${vpn_ip//$'\n'/} - if [[ -n "$host_ip" && -n "$vpn_ip" && "$host_ip" != "$vpn_ip" ]]; then - check_ok "VPN egress is distinct from host egress ($vpn_ip vs $host_ip)" - elif [[ -n "$host_ip" && "$host_ip" == "$vpn_ip" ]]; then - check_fail "VPN and host public IP are identical ($host_ip); stop Transmission and inspect Gluetun" + done < <(compose config --services 2>/dev/null || true) + + gluetun_id=$(compose ps -q gluetun 2>/dev/null || true) + transmission_id=$(compose ps -q transmission 2>/dev/null || true) + if [[ -n "$gluetun_id" && -n "$transmission_id" ]]; then + network_mode=$(docker inspect --format '{{.HostConfig.NetworkMode}}' "$transmission_id" 2>/dev/null || true) + [[ "$network_mode" == "container:$gluetun_id" ]] && check_ok "Transmission shares Gluetun network namespace" || check_fail "Transmission is not isolated behind Gluetun" + fi + + probe_http Jellyfin http://127.0.0.1:8096/System/Info/Public + probe_http Seerr http://127.0.0.1:5055/api/v1/settings/public + probe_http Radarr http://127.0.0.1:7878/ping + probe_http Sonarr http://127.0.0.1:8989/ping + probe_http Prowlarr http://127.0.0.1:9696/ping + probe_http Bazarr http://127.0.0.1:6767/ + + if [[ -s "$STACK_DIR/secrets/transmission_user" && -s "$STACK_DIR/secrets/transmission_password" ]] && + curl --fail --silent --max-time 8 -u "$(<"$STACK_DIR/secrets/transmission_user"):$(<"$STACK_DIR/secrets/transmission_password")" \ + http://127.0.0.1:9091/transmission/web/ >/dev/null 2>&1; then + check_ok "Transmission accepts configured credentials" + else + check_fail "Transmission credentials/API check failed" + fi + + host_ip=$(curl --fail --silent --max-time 10 https://api.ipify.org 2>/dev/null || true) + vpn_ip=$(compose exec -T gluetun wget -qO- -T 10 https://api.ipify.org 2>/dev/null || true) + host_ip=${host_ip//$'\n'/}; vpn_ip=${vpn_ip//$'\n'/} + if [[ -n "$host_ip" && -n "$vpn_ip" && "$host_ip" != "$vpn_ip" ]]; then + check_ok "VPN egress differs from host egress ($vpn_ip vs $host_ip)" + elif [[ -n "$host_ip" && "$host_ip" == "$vpn_ip" ]]; then + check_fail "VPN and host public IP are identical ($host_ip)" + else + check_warn "Could not compare host and VPN public IPs" + fi + + forwarded_port=$(read_forwarded_port || true) + [[ -n "$forwarded_port" ]] && check_ok "ProtonVPN assigned forwarded port $forwarded_port" || check_warn "No valid ProtonVPN forwarded port detected" + + bazarr_key=$(bazarr_api_key || true) + if [[ -n "$bazarr_key" ]]; then + bazarr_settings=$(curl -fsS --max-time 8 -H "X-API-KEY: $bazarr_key" http://127.0.0.1:6767/api/system/settings 2>/dev/null || true) + if jq -e '.general.use_sonarr == true and .general.use_radarr == true and .sonarr.ip == "sonarr" and .radarr.ip == "radarr"' <<<"$bazarr_settings" >/dev/null 2>&1; then + check_ok "Bazarr is integrated with Sonarr and Radarr" else - check_warn "Could not compare public host and VPN addresses" + check_warn "Bazarr integration is incomplete; run: media-stack configure" fi - - forwarded_port=$(compose exec -T gluetun cat /tmp/gluetun/forwarded_port 2>/dev/null || true) - forwarded_port=${forwarded_port//$'\n'/} - if [[ "$forwarded_port" =~ ^[0-9]+$ ]] && ((forwarded_port > 0 && forwarded_port < 65536)); then - check_ok "ProtonVPN assigned forwarded port $forwarded_port" + else + check_warn "Bazarr API key could not be read" + fi + + render_gid=$(read_env RENDER_GID) + if [[ -n "$render_gid" ]]; then + if [[ -c /dev/dri/renderD128 ]] && compose exec -T jellyfin test -c /dev/dri/renderD128 >/dev/null 2>&1; then + check_ok "Jellyfin can see /dev/dri/renderD128" + if compose exec -T jellyfin /usr/lib/jellyfin-ffmpeg/vainfo --display drm --device /dev/dri/renderD128 >/dev/null 2>&1; then + check_ok "Jellyfin VA-API driver probe succeeds" + else + check_fail "Jellyfin render device exists but vainfo failed" + fi else - check_warn "ProtonVPN has not assigned a valid forwarded port" - fi - - offsite_dir=$(read_env OFFSITE_BACKUP_DIR) - if [[ -n "$offsite_dir" ]]; then - offsite_source=$(read_env OFFSITE_BACKUP_SOURCE) - offsite_mount=$(read_env OFFSITE_BACKUP_MOUNTPOINT) - current_source="" - current_target="" - read -r current_source current_target < <(findmnt -T "$offsite_dir" -n -o SOURCE,TARGET --first 2>/dev/null || true) - if [[ "$current_source" == "$offsite_source" && "$current_target" == "$offsite_mount" && -w "$offsite_dir" ]]; then - check_ok "External backup mount identity is unchanged ($offsite_source on $offsite_mount)" - else - check_fail "External backup mount is missing or changed; refusing silent fallback to local storage" - fi + check_fail "GPU support is enabled but Jellyfin cannot access renderD128" fi + else + check_warn "Hardware transcoding is not enabled in this stack" + fi - for unit in media-stack-update.timer media-stack-port-sync.timer; do - if systemctl is-enabled --quiet "$unit" && systemctl is-active --quiet "$unit"; then - check_ok "$unit is enabled and active" - else - check_fail "$unit is not enabled and active" - fi - done - if [[ "$(read_env ENABLE_TAILSCALE)" == yes ]]; then - tailscale_ip=$(tailscale ip -4 2>/dev/null | awk 'NR == 1' || true) - if [[ -n "$tailscale_ip" ]]; then check_ok "Tailscale is connected"; else check_fail "Tailscale is disconnected"; fi - fi - - printf '\nDoctor result: %d failure(s), %d warning(s).\n' "$CHECK_FAILURES" "$CHECK_WARNINGS" - ((CHECK_FAILURES == 0)) -} + for unit in media-stack-update.timer media-stack-port-sync.timer; do + systemctl is-enabled --quiet "$unit" && systemctl is-active --quiet "$unit" && check_ok "$unit is enabled and active" || check_fail "$unit is not enabled and active" + done -api_key_from_config() { - local file=$1 - sed -n 's:.*\([^<]*\).*:\1:p' "$file" 2>/dev/null | awk 'NR == 1' || true + printf '\nDoctor result: %d failure(s), %d warning(s).\n' "$CHECK_FAILURES" "$CHECK_WARNINGS" + ((CHECK_FAILURES == 0)) } wait_http() { - local url=$1 deadline=$((SECONDS + 120)) - until curl --fail --silent --max-time 4 "$url" >/dev/null 2>&1; do - ((SECONDS < deadline)) || return 1 - sleep 3 - done + local url=$1 deadline=$((SECONDS+180)) + until curl --fail --silent --max-time 4 "$url" >/dev/null 2>&1; do + ((SECONDS < deadline)) || return 1 + sleep 3 + done } api_request() { - local method=$1 url=$2 api_key=$3 payload=${4:-} response - response=$(mktemp) - if [[ -n "$payload" ]]; then - if ! curl --fail --silent --show-error --max-time 20 -X "$method" \ - -H "X-Api-Key: $api_key" -H 'Content-Type: application/json' \ - --data "$payload" "$url" > "$response"; then - rm -f "$response" - return 1 - fi - else - if ! curl --fail --silent --show-error --max-time 20 -X "$method" \ - -H "X-Api-Key: $api_key" "$url" > "$response"; then - rm -f "$response" - return 1 - fi - fi - cat "$response" - rm -f "$response" + local method=$1 url=$2 api_key=$3 payload=${4:-} response + response=$(mktemp) + if [[ -n "$payload" ]]; then + curl --fail --silent --show-error --max-time 20 -X "$method" -H "X-Api-Key: $api_key" -H 'Content-Type: application/json' --data "$payload" "$url" >"$response" || { rm -f "$response"; return 1; } + else + curl --fail --silent --show-error --max-time 20 -X "$method" -H "X-Api-Key: $api_key" "$url" >"$response" || { rm -f "$response"; return 1; } + fi + cat "$response"; rm -f "$response" } ensure_root_folder() { - local name=$1 base_url=$2 api_key=$3 path=$4 existing payload - existing=$(api_request GET "$base_url/rootfolder" "$api_key") - if jq -e --arg path "$path" '.[] | select(.path == $path)' <<< "$existing" >/dev/null; then - $QUIET || ok "$name root folder already exists: $path" - return - fi - payload=$(jq -cn --arg path "$path" '{path:$path}') - api_request POST "$base_url/rootfolder" "$api_key" "$payload" >/dev/null - $QUIET || ok "$name root folder created: $path" + local name=$1 base_url=$2 api_key=$3 path=$4 existing payload + existing=$(api_request GET "$base_url/rootfolder" "$api_key") + if jq -e --arg path "$path" '.[] | select(.path == $path)' <<<"$existing" >/dev/null; then + $QUIET || ok "$name root folder already exists: $path"; return + fi + payload=$(jq -cn --arg path "$path" '{path:$path}') + api_request POST "$base_url/rootfolder" "$api_key" "$payload" >/dev/null + $QUIET || ok "$name root folder created: $path" } ensure_transmission_client() { - local name=$1 base_url=$2 api_key=$3 category=$4 clients existing schema payload id method url - clients=$(api_request GET "$base_url/downloadclient" "$api_key") - existing=$(jq -c '[.[] | select(.name == "Media Stack Transmission")][0] // empty' <<< "$clients") - if [[ -n "$existing" ]]; then - payload=$existing - id=$(jq -r '.id' <<< "$existing") - method=PUT - url="$base_url/downloadclient/$id" - else - schema=$(api_request GET "$base_url/downloadclient/schema" "$api_key") - payload=$(jq -c '[.[] | select(.implementation == "Transmission")][0] // empty' <<< "$schema") - [[ -n "$payload" ]] || die "$name did not expose a Transmission download-client schema." - method=POST - url="$base_url/downloadclient" - fi - payload=$(jq -c \ - --arg username "$(<"$STACK_DIR/secrets/transmission_user")" \ - --arg password "$(<"$STACK_DIR/secrets/transmission_password")" \ - --arg category "$category" ' - .name = "Media Stack Transmission" | - .enable = true | - .priority = 1 | - .fields |= map( - if .name == "host" then .value = "gluetun" - elif .name == "port" then .value = 9091 - elif .name == "useSsl" then .value = false - elif .name == "urlBase" then .value = "/transmission/" - elif .name == "username" then .value = $username - elif .name == "password" then .value = $password - elif (.name == "category" or .name == "movieCategory" or .name == "tvCategory") then .value = $category - elif .name == "addPaused" then .value = false - else . end - ) - ' <<< "$payload") - api_request "$method" "$url" "$api_key" "$payload" >/dev/null - $QUIET || ok "$name is wired to Transmission with category $category" + local name=$1 base_url=$2 api_key=$3 category=$4 clients existing schema payload id method url + clients=$(api_request GET "$base_url/downloadclient" "$api_key") + existing=$(jq -c '[.[] | select(.name == "Media Stack Transmission")][0] // empty' <<<"$clients") + if [[ -n "$existing" ]]; then + payload=$existing; id=$(jq -r '.id' <<<"$existing"); method=PUT; url="$base_url/downloadclient/$id" + else + schema=$(api_request GET "$base_url/downloadclient/schema" "$api_key") + payload=$(jq -c '[.[] | select(.implementation == "Transmission")][0] // empty' <<<"$schema") + [[ -n "$payload" ]] || die "$name did not expose a Transmission client schema" + method=POST; url="$base_url/downloadclient" + fi + payload=$(jq -c \ + --arg username "$(<"$STACK_DIR/secrets/transmission_user")" \ + --arg password "$(<"$STACK_DIR/secrets/transmission_password")" \ + --arg category "$category" ' + .name="Media Stack Transmission" | .enable=true | .priority=1 | + .fields |= map( + if .name=="host" then .value="gluetun" + elif .name=="port" then .value=9091 + elif .name=="useSsl" then .value=false + elif .name=="urlBase" then .value="/transmission/" + elif .name=="username" then .value=$username + elif .name=="password" then .value=$password + elif (.name=="category" or .name=="movieCategory" or .name=="tvCategory") then .value=$category + elif .name=="addPaused" then .value=false + else . end) + ' <<<"$payload") + api_request "$method" "$url" "$api_key" "$payload" >/dev/null + $QUIET || ok "$name is wired to Transmission with category $category" } ensure_prowlarr_application() { - local implementation=$1 target_url=$2 target_key=$3 prowlarr_key=$4 base_url existing applications schema payload id method url - base_url=http://127.0.0.1:9696/api/v1 - applications=$(api_request GET "$base_url/applications" "$prowlarr_key") - existing=$(jq -c --arg impl "$implementation" '[.[] | select(.implementation == $impl)][0] // empty' <<< "$applications") - if [[ -n "$existing" ]]; then - payload=$existing - id=$(jq -r '.id' <<< "$existing") - method=PUT - url="$base_url/applications/$id" - else - schema=$(api_request GET "$base_url/applications/schema" "$prowlarr_key") - payload=$(jq -c --arg impl "$implementation" '[.[] | select(.implementation == $impl)][0] // empty' <<< "$schema") - [[ -n "$payload" ]] || die "Prowlarr did not expose the $implementation application schema." - method=POST - url="$base_url/applications" - fi - payload=$(jq -c --arg name "Media Stack $implementation" --arg target "$target_url" --arg key "$target_key" ' - .name = $name | - .enable = true | - .syncLevel = "fullSync" | - .fields |= map( - if .name == "prowlarrUrl" then .value = "http://prowlarr:9696" - elif .name == "baseUrl" then .value = $target - elif .name == "apiKey" then .value = $key - else . end - ) - ' <<< "$payload") - api_request "$method" "$url" "$prowlarr_key" "$payload" >/dev/null - $QUIET || ok "Prowlarr is wired to $implementation" + local implementation=$1 target_url=$2 target_key=$3 prowlarr_key=$4 base_url applications existing schema payload id method url + base_url=http://127.0.0.1:9696/api/v1 + applications=$(api_request GET "$base_url/applications" "$prowlarr_key") + existing=$(jq -c --arg impl "$implementation" '[.[] | select(.implementation == $impl)][0] // empty' <<<"$applications") + if [[ -n "$existing" ]]; then + payload=$existing; id=$(jq -r '.id' <<<"$existing"); method=PUT; url="$base_url/applications/$id" + else + schema=$(api_request GET "$base_url/applications/schema" "$prowlarr_key") + payload=$(jq -c --arg impl "$implementation" '[.[] | select(.implementation == $impl)][0] // empty' <<<"$schema") + [[ -n "$payload" ]] || die "Prowlarr did not expose the $implementation application schema" + method=POST; url="$base_url/applications" + fi + payload=$(jq -c --arg name "Media Stack $implementation" --arg target "$target_url" --arg key "$target_key" ' + .name=$name | .enable=true | .syncLevel="fullSync" | + .fields |= map( + if .name=="prowlarrUrl" then .value="http://prowlarr:9696" + elif .name=="baseUrl" then .value=$target + elif .name=="apiKey" then .value=$key + else . end) + ' <<<"$payload") + api_request "$method" "$url" "$prowlarr_key" "$payload" >/dev/null + $QUIET || ok "Prowlarr is wired to $implementation" } -command_configure() { - QUIET=false - case "${1:-}" in - "") ;; - --quiet) QUIET=true ;; - *) die "Usage: media-stack configure [--quiet]" ;; - esac - [[ -s "$STACK_DIR/secrets/transmission_user" && -s "$STACK_DIR/secrets/transmission_password" ]] || - die "Transmission credential files are missing." - wait_http http://127.0.0.1:7878/ping || die "Radarr did not become ready." - wait_http http://127.0.0.1:8989/ping || die "Sonarr did not become ready." - wait_http http://127.0.0.1:9696/ping || die "Prowlarr did not become ready." - - radarr_key=$(api_key_from_config "$STACK_DIR/config/radarr/config.xml") - sonarr_key=$(api_key_from_config "$STACK_DIR/config/sonarr/config.xml") - prowlarr_key=$(api_key_from_config "$STACK_DIR/config/prowlarr/config.xml") - [[ -n "$radarr_key" && -n "$sonarr_key" && -n "$prowlarr_key" ]] || die "Could not read one or more ARR API keys." - - ensure_root_folder Radarr http://127.0.0.1:7878/api/v3 "$radarr_key" /data/media/movies - ensure_root_folder Sonarr http://127.0.0.1:8989/api/v3 "$sonarr_key" /data/media/tv - ensure_transmission_client Radarr http://127.0.0.1:7878/api/v3 "$radarr_key" movies - ensure_transmission_client Sonarr http://127.0.0.1:8989/api/v3 "$sonarr_key" tv - ensure_prowlarr_application Radarr http://radarr:7878 "$radarr_key" "$prowlarr_key" - ensure_prowlarr_application Sonarr http://sonarr:8989 "$sonarr_key" "$prowlarr_key" - $QUIET || ok "ARR wiring is complete and idempotent." +ensure_bazarr_integration() { + local sonarr_key=$1 radarr_key=$2 key settings + key=$(bazarr_api_key || true) + [[ -n "$key" ]] || die "Could not read Bazarr API key from config" + + curl --fail --silent --show-error --max-time 30 -X POST \ + -H "X-API-KEY: $key" \ + --data-urlencode 'settings-general-use_sonarr=true' \ + --data-urlencode 'settings-sonarr-ip=sonarr' \ + --data-urlencode 'settings-sonarr-port=8989' \ + --data-urlencode 'settings-sonarr-base_url=/' \ + --data-urlencode 'settings-sonarr-ssl=false' \ + --data-urlencode "settings-sonarr-apikey=$sonarr_key" \ + --data-urlencode 'settings-general-use_radarr=true' \ + --data-urlencode 'settings-radarr-ip=radarr' \ + --data-urlencode 'settings-radarr-port=7878' \ + --data-urlencode 'settings-radarr-base_url=/' \ + --data-urlencode 'settings-radarr-ssl=false' \ + --data-urlencode "settings-radarr-apikey=$radarr_key" \ + http://127.0.0.1:6767/api/system/settings >/dev/null + + settings=$(curl -fsS --max-time 15 -H "X-API-KEY: $key" http://127.0.0.1:6767/api/system/settings) + jq -e --arg sk "$sonarr_key" --arg rk "$radarr_key" ' + .general.use_sonarr==true and .general.use_radarr==true and + .sonarr.ip=="sonarr" and .sonarr.port==8989 and .sonarr.apikey==$sk and + .radarr.ip=="radarr" and .radarr.port==7878 and .radarr.apikey==$rk + ' <<<"$settings" >/dev/null || die "Bazarr did not persist Sonarr/Radarr integration" + $QUIET || ok "Bazarr is wired to Sonarr and Radarr" } -configure_tailscale_serve() { - [[ "$(read_env ENABLE_TAILSCALE)" == yes ]] || return 0 - command -v tailscale >/dev/null || return 0 - for port in 5055 6767 7878 8096 8989 9091 9696; do - tailscale serve --bg --https="$port" "http://127.0.0.1:$port" >/dev/null - done +command_configure() { + QUIET=false + case "${1:-}" in "") ;; --quiet) QUIET=true ;; *) die "Usage: media-stack configure [--quiet]" ;; esac + [[ -s "$STACK_DIR/secrets/transmission_user" && -s "$STACK_DIR/secrets/transmission_password" ]] || die "Transmission credentials are missing" + wait_http http://127.0.0.1:7878/ping || die "Radarr did not become ready" + wait_http http://127.0.0.1:8989/ping || die "Sonarr did not become ready" + wait_http http://127.0.0.1:9696/ping || die "Prowlarr did not become ready" + wait_http http://127.0.0.1:6767/ || die "Bazarr did not become ready" + + local radarr_key sonarr_key prowlarr_key + radarr_key=$(api_key_from_config "$STACK_DIR/config/radarr/config.xml") + sonarr_key=$(api_key_from_config "$STACK_DIR/config/sonarr/config.xml") + prowlarr_key=$(api_key_from_config "$STACK_DIR/config/prowlarr/config.xml") + [[ -n "$radarr_key" && -n "$sonarr_key" && -n "$prowlarr_key" ]] || die "Could not read one or more *Arr API keys" + + ensure_root_folder Radarr http://127.0.0.1:7878/api/v3 "$radarr_key" /data/media/movies + ensure_root_folder Sonarr http://127.0.0.1:8989/api/v3 "$sonarr_key" /data/media/tv + ensure_transmission_client Radarr http://127.0.0.1:7878/api/v3 "$radarr_key" movies + ensure_transmission_client Sonarr http://127.0.0.1:8989/api/v3 "$sonarr_key" tv + ensure_prowlarr_application Radarr http://radarr:7878 "$radarr_key" "$prowlarr_key" + ensure_prowlarr_application Sonarr http://sonarr:8989 "$sonarr_key" "$prowlarr_key" + ensure_bazarr_integration "$sonarr_key" "$radarr_key" + $QUIET || ok "Automatic stack wiring is complete" } command_repair_ip() { - local old_ip new_ip escaped_old - [[ $EUID -eq 0 ]] || die "repair-ip must run as root." - old_ip=$(read_env LAN_IP) - new_ip=$(detect_lan_ip) - [[ -n "$new_ip" ]] || die "Could not detect the current LAN IPv4 address." - if [[ "$old_ip" == "$new_ip" ]] && ip -4 addr show | grep -Fq " $new_ip/"; then - ok "The configured LAN IP is already current: $new_ip" - configure_tailscale_serve - return - fi - info "Changing Docker bindings from $old_ip to $new_ip." - write_env LAN_IP "$new_ip" - if ! compose up -d --remove-orphans --force-recreate --wait --wait-timeout 420; then - write_env LAN_IP "$old_ip" - compose up -d --remove-orphans || true - die "Containers failed with $new_ip; restored $old_ip." - fi - configure_tailscale_serve - if [[ -f "$STACK_DIR/important_info.md" ]]; then - escaped_old=${old_ip//./\\.} - sed -i "s/${escaped_old}/${new_ip}/g" "$STACK_DIR/important_info.md" - fi - ok "LAN bindings were repaired for $new_ip." + local old_ip new_ip escaped_old + [[ $EUID -eq 0 ]] || die "repair-ip must run as root" + old_ip=$(read_env LAN_IP); new_ip=$(detect_lan_ip) + [[ -n "$new_ip" ]] || die "Could not detect current LAN IPv4 address" + if [[ "$old_ip" == "$new_ip" ]] && ip -4 addr show | grep -Fq " $new_ip/"; then ok "LAN IP is already current: $new_ip"; return; fi + info "Changing Docker bindings from $old_ip to $new_ip" + write_env LAN_IP "$new_ip" + if ! compose up -d --remove-orphans --force-recreate --wait --wait-timeout 420; then + write_env LAN_IP "$old_ip"; compose up -d --remove-orphans || true; die "Containers failed with $new_ip; restored $old_ip" + fi + if [[ -f "$STACK_DIR/important_info.md" ]]; then + escaped_old=${old_ip//./\\.}; sed -i "s/${escaped_old}/${new_ip}/g" "$STACK_DIR/important_info.md" + fi + ok "LAN bindings repaired for $new_ip" } validate_offsite_mount() { - local directory source target current_source current_target - directory=$(read_env OFFSITE_BACKUP_DIR) - [[ -n "$directory" ]] || return 0 - source=$(read_env OFFSITE_BACKUP_SOURCE) - target=$(read_env OFFSITE_BACKUP_MOUNTPOINT) - current_source="" - current_target="" - read -r current_source current_target < <(findmnt -T "$directory" -n -o SOURCE,TARGET --first 2>/dev/null || true) - [[ "$current_source" == "$source" && "$current_target" == "$target" && -w "$directory" ]] || - die "External backup filesystem identity changed or is unavailable: $directory" + local directory source target current_source current_target + directory=$(read_env OFFSITE_BACKUP_DIR); [[ -n "$directory" ]] || return 0 + source=$(read_env OFFSITE_BACKUP_SOURCE); target=$(read_env OFFSITE_BACKUP_MOUNTPOINT) + read -r current_source current_target < <(findmnt -T "$directory" -n -o SOURCE,TARGET --first 2>/dev/null || true) + [[ "$current_source" == "$source" && "$current_target" == "$target" && -w "$directory" ]] || die "External backup filesystem is unavailable or changed: $directory" } command_backup() { - local state_dir backup_dir timestamp temporary backup offsite stack_stopped - local item - local -a items existing_items - [[ $EUID -eq 0 ]] || die "backup must run as root." - state_dir="$STACK_DIR/.update-state" - backup_dir="$STACK_DIR/backups" - mkdir -p "$state_dir" "$backup_dir" - exec 9>"$state_dir/update.lock" - flock -n 9 || die "An update or backup is already running." - validate_offsite_mount - timestamp=$(date +%Y%m%d-%H%M%S) - temporary="$backup_dir/.media-stack-$timestamp.tar.gz.partial" - backup="$backup_dir/media-stack-$timestamp.tar.gz" - stack_stopped=false - restart_stack_on_exit() { - local status=$? - trap - EXIT - if $stack_stopped; then - compose up -d --remove-orphans --wait --wait-timeout 420 || true - fi - exit "$status" - } - trap restart_stack_on_exit EXIT - compose stop --timeout 60 - stack_stopped=true - items=(config secrets .env compose.yaml compose.openvpn.yaml compose.wireguard.yaml compose.gpu.yaml important_info.md update_stack.sh sync_transmission_port.sh media_stack.sh) - existing_items=() - for item in "${items[@]}"; do - [[ -e "$STACK_DIR/$item" ]] && existing_items+=("$item") - done - ((${#existing_items[@]} > 0)) || die "No stack configuration files were found to back up." - tar -czf "$temporary" -C "$STACK_DIR" "${existing_items[@]}" - tar -tzf "$temporary" >/dev/null - mv "$temporary" "$backup" - offsite=$(read_env OFFSITE_BACKUP_DIR) - if [[ -n "$offsite" ]]; then - validate_offsite_mount - cp -a "$backup" "$offsite/" - fi - compose up -d --remove-orphans --wait --wait-timeout 420 - stack_stopped=false - trap - EXIT INT TERM - ok "Consistent backup created: $backup" + local state_dir backup_dir timestamp temporary backup offsite stack_stopped item + local -a items existing_items + [[ $EUID -eq 0 ]] || die "backup must run as root" + state_dir="$STACK_DIR/.update-state"; backup_dir="$STACK_DIR/backups"; mkdir -p "$state_dir" "$backup_dir" + exec 9>"$state_dir/update.lock"; flock -n 9 || die "An update or backup is already running" + validate_offsite_mount + timestamp=$(date +%Y%m%d-%H%M%S); temporary="$backup_dir/.media-stack-$timestamp.tar.gz.partial"; backup="$backup_dir/media-stack-$timestamp.tar.gz" + stack_stopped=false + restart_stack_on_exit() { local status=$?; trap - EXIT; $stack_stopped && compose up -d --remove-orphans --wait --wait-timeout 420 || true; exit "$status"; } + trap restart_stack_on_exit EXIT + compose stop --timeout 60; stack_stopped=true + items=(config secrets .env compose.yaml compose.openvpn.yaml compose.wireguard.yaml compose.gpu.yaml important_info.md update_stack.sh sync_transmission_port.sh media_stack.sh) + existing_items=(); for item in "${items[@]}"; do [[ -e "$STACK_DIR/$item" ]] && existing_items+=("$item"); done + ((${#existing_items[@]} > 0)) || die "No stack configuration files found" + tar -czf "$temporary" -C "$STACK_DIR" "${existing_items[@]}"; tar -tzf "$temporary" >/dev/null; mv "$temporary" "$backup" + offsite=$(read_env OFFSITE_BACKUP_DIR); if [[ -n "$offsite" ]]; then validate_offsite_mount; cp -a "$backup" "$offsite/"; fi + compose up -d --remove-orphans --wait --wait-timeout 420; stack_stopped=false; trap - EXIT + ok "Consistent backup created: $backup" } command_logs() { - local service=${1:-} - [[ -n "$service" ]] || die "Usage: media-stack logs SERVICE" - if ! compose config --services | grep -Fxq "$service"; then - die "Unknown or disabled service: $service" - fi - compose logs --tail=200 --follow "$service" + local service=${1:-}; [[ -n "$service" ]] || die "Usage: media-stack logs SERVICE" + compose config --services | grep -Fxq "$service" || die "Unknown or disabled service: $service" + compose logs --tail=200 --follow "$service" } case "${1:-help}" in - status) shift; (($# == 0)) || die "status takes no arguments."; command_status ;; - doctor) shift; (($# == 0)) || die "doctor takes no arguments."; command_doctor ;; - configure) shift; (($# <= 1)) || die "Usage: media-stack configure [--quiet]"; command_configure "${1:-}" ;; - repair-ip) shift; (($# == 0)) || die "repair-ip takes no arguments."; command_repair_ip ;; - backup) shift; (($# == 0)) || die "backup takes no arguments."; command_backup ;; - logs) shift; (($# == 1)) || die "Usage: media-stack logs SERVICE"; command_logs "$1" ;; - *) usage >&2; die "Unknown command: $1" ;; + status) shift; (($#==0)) || die "status takes no arguments"; command_status ;; + doctor) shift; (($#==0)) || die "doctor takes no arguments"; command_doctor ;; + configure) shift; (($#<=1)) || die "Usage: media-stack configure [--quiet]"; command_configure "${1:-}" ;; + repair-ip) shift; (($#==0)) || die "repair-ip takes no arguments"; command_repair_ip ;; + backup) shift; (($#==0)) || die "backup takes no arguments"; command_backup ;; + logs) shift; (($#==1)) || die "Usage: media-stack logs SERVICE"; command_logs "$1" ;; + *) usage >&2; die "Unknown command: $1" ;; esac diff --git a/proxmox_lxc.sh b/proxmox_lxc.sh old mode 100644 new mode 100755 index 3c16b80..68ac3e3 --- a/proxmox_lxc.sh +++ b/proxmox_lxc.sh @@ -1,13 +1,13 @@ #!/usr/bin/env bash -# This script runs on the Proxmox VE host. It creates an unprivileged LXC, -# passes through the required devices, optionally bind-mounts an existing -# host filesystem for media, and launches install_media.sh inside the LXC. +# Runs on the Proxmox VE host. Creates an unprivileged Debian LXC, passes the +# devices needed by Gluetun/Jellyfin, optionally attaches media storage and then +# executes install_media.sh inside the guest. Docker never runs on the PVE host. set -Eeuo pipefail umask 077 -readonly PROVISIONER_VERSION="4.0.0" +readonly PROVISIONER_VERSION="5.0.0" readonly PROJECT_REPOSITORY="placq/media-stack" readonly MEDIA_MOUNTPOINT="/opt/media-stack/data" readonly DEFAULT_HOST_MEDIA_PATH="/srv/media" @@ -24,28 +24,28 @@ warn() { printf '%b[WARN]%b %s\n' "$YELLOW" "$NC" "$*" >&2; } die() { printf '%b[ERROR]%b %s\n' "$RED" "$NC" "$*" >&2; exit 1; } usage() { - cat <<'EOF' + cat <<'USAGE' Media Stack LXC provisioner (run on a Proxmox VE host) Usage: bash proxmox_lxc.sh bash proxmox_lxc.sh --help -The script creates a new unprivileged Debian 13 LXC and then runs the media -installer inside that LXC. It never runs Docker or media services on the -Proxmox host itself. - -Media storage can be: - host an already-mounted host filesystem/directory such as /srv/media - proxmox a new Proxmox-managed volume - none no separate media storage; data remains inside the LXC rootfs - -For "host", the provisioner refuses to use a path backed by the Proxmox root -filesystem. It creates a storage sentinel, prepares the standard media -directories for UID/GID 1000 inside the unprivileged LXC, tests write access -and hardlinks, and installs a Docker startup guard so a missing/wrong media -filesystem cannot silently receive downloads on the system disk. -EOF +Creates an unprivileged Debian 13 LXC for the media stack. The guest gets: + - nesting/keyctl for Docker + - /dev/net/tun for Gluetun/ProtonVPN + - optional /dev/dri/renderD128 for Jellyfin hardware transcoding + - optional dedicated media storage + +Media storage modes: + host bind-mount an already-mounted host filesystem/directory + proxmox create a Proxmox-managed mount-point volume + none keep /data inside the LXC root filesystem + +The "host" mode refuses paths backed by the Proxmox root filesystem, validates +UID/GID mapping and hardlinks, writes a storage sentinel and installs a Docker +startup guard. This prevents a missing media disk from silently filling rootfs. +USAGE } case "${1:-}" in @@ -56,10 +56,10 @@ esac [[ $EUID -eq 0 ]] || die "Run this script as root on the Proxmox VE host." [[ -t 0 ]] || die "An interactive Proxmox shell is required; do not pipe this script to bash." -if ! command -v pveversion >/dev/null || ! command -v pct >/dev/null || ! command -v pveam >/dev/null; then - die "This is not a Proxmox VE host (pveversion/pct/pveam are missing)." -fi -[[ -e /dev/net/tun ]] || die "The Proxmox host has no /dev/net/tun device." +for cmd in pveversion pct pveam pvesm pvesh; do + command -v "$cmd" >/dev/null || die "Missing Proxmox command: $cmd" +done +[[ -c /dev/net/tun ]] || die "The Proxmox host has no /dev/net/tun character device." mkdir -p /run/lock exec 8>/run/lock/media-stack-lxc-provisioner.lock @@ -93,7 +93,7 @@ prompt() { yes_no() { local variable=$1 label=$2 default=${3:-yes} answer suffix - if [[ "$default" == yes ]]; then suffix=Y/n; else suffix=y/N; fi + [[ "$default" == yes ]] && suffix=Y/n || suffix=y/N read -r -p "$label ($suffix): " answer case "$answer" in [Yy]|[Yy][Ee][Ss]) printf -v "$variable" yes ;; @@ -120,9 +120,8 @@ valid_ipv4() { IFS=. read -r -a octets <<< "$address" ((${#octets[@]} == 4)) || return 1 for octet in "${octets[@]}"; do - if [[ ! "$octet" =~ ^[0-9]{1,3}$ ]] || ((10#$octet > 255)); then - return 1 - fi + [[ "$octet" =~ ^[0-9]{1,3}$ ]] || return 1 + ((10#$octet <= 255)) || return 1 done } @@ -137,11 +136,8 @@ validate_host_media_path() { backing_target=$(findmnt -T "$path" -n -o TARGET --first 2>/dev/null || true) backing_source=$(findmnt -T "$path" -n -o SOURCE --first 2>/dev/null || true) backing_fstype=$(findmnt -T "$path" -n -o FSTYPE --first 2>/dev/null || true) - - [[ -n "$backing_target" && -n "$backing_source" ]] || - die "Unable to determine the filesystem backing $path." - [[ "$backing_target" != "/" ]] || - die "$path is currently backed by the Proxmox root filesystem. Mount the media disk first." + [[ -n "$backing_target" && -n "$backing_source" ]] || die "Unable to determine the filesystem backing $path." + [[ "$backing_target" != / ]] || die "$path is backed by the Proxmox root filesystem. Mount the media disk first." [[ -w "$path" ]] || die "Host media path is not writable by root: $path" HOST_MEDIA_BACKING_TARGET=$backing_target @@ -151,18 +147,12 @@ validate_host_media_path() { prepare_host_media_path() { local path=$1 test_source test_target - command -v setpriv >/dev/null || - die "setpriv is required on the Proxmox host (normally provided by util-linux)." + command -v setpriv >/dev/null || die "setpriv is required on the Proxmox host (util-linux)." info "Preparing media directories on $path without recursively changing existing files..." install -d -m 0775 -o "$MEDIA_HOST_UID" -g "$MEDIA_HOST_GID" \ - "$path/torrents" \ - "$path/torrents/movies" \ - "$path/torrents/tv" \ - "$path/torrents/incomplete" \ - "$path/media" \ - "$path/media/movies" \ - "$path/media/tv" + "$path/torrents" "$path/torrents/movies" "$path/torrents/tv" "$path/torrents/incomplete" \ + "$path/media" "$path/media/movies" "$path/media/tv" STORAGE_TOKEN=$(cat /proc/sys/kernel/random/uuid) printf '%s\n' "$STORAGE_TOKEN" > "$path/.media-stack-storage" @@ -171,15 +161,12 @@ prepare_host_media_path() { test_source="$path/torrents/.media-stack-write-test-$$" test_target="$path/media/.media-stack-hardlink-test-$$" rm -f -- "$test_source" "$test_target" - - if ! setpriv --reuid="$MEDIA_HOST_UID" --regid="$MEDIA_HOST_GID" --clear-groups \ - -- touch "$test_source"; then + if ! setpriv --reuid="$MEDIA_HOST_UID" --regid="$MEDIA_HOST_GID" --clear-groups -- touch "$test_source"; then die "Mapped LXC UID $MEDIA_CONTAINER_UID (host UID $MEDIA_HOST_UID) cannot write to $path/torrents." fi - if ! setpriv --reuid="$MEDIA_HOST_UID" --regid="$MEDIA_HOST_GID" --clear-groups \ - -- ln "$test_source" "$test_target"; then + if ! setpriv --reuid="$MEDIA_HOST_UID" --regid="$MEDIA_HOST_GID" --clear-groups -- ln "$test_source" "$test_target"; then rm -f -- "$test_source" "$test_target" - die "Hardlinks do not work between $path/torrents and $path/media. They must share one filesystem." + die "Hardlinks do not work between torrents and media. Keep both on one filesystem." fi rm -f -- "$test_source" "$test_target" } @@ -187,7 +174,7 @@ prepare_host_media_path() { install_host_media_guard() { local escaped_token escaped_token=$(printf '%q' "$STORAGE_TOKEN") - info "Installing Docker startup guard for the host media filesystem..." + info "Installing Docker startup guard for the media filesystem..." pct exec "$CTID" -- bash -c " set -Eeuo pipefail install -d -m 0755 /usr/local/sbin /etc/systemd/system/docker.service.d @@ -230,16 +217,16 @@ DEFAULT_ROOT_STORAGE=$(first_storage_for rootdir) [[ -n "$DEFAULT_ROOT_STORAGE" ]] || die "No active Proxmox storage supports LXC root directories." prompt ROOT_STORAGE "Root filesystem storage" "$DEFAULT_ROOT_STORAGE" storage_supports "$ROOT_STORAGE" rootdir || die "Storage $ROOT_STORAGE is not active or does not support rootdir content." -prompt ROOT_DISK_GB "Root filesystem size in GiB" 32 -if [[ ! "$ROOT_DISK_GB" =~ ^[0-9]+$ ]] || ((ROOT_DISK_GB < 16)); then - die "Root disk must be at least 16 GiB." +prompt ROOT_DISK_GB "Root filesystem size in GiB" 64 +if [[ ! "$ROOT_DISK_GB" =~ ^[0-9]+$ ]] || ((ROOT_DISK_GB < 24)); then + die "Root disk must be at least 24 GiB." fi prompt CORES "CPU cores" 4 prompt MEMORY_MB "Memory in MiB" 8192 prompt SWAP_MB "Swap in MiB" 512 -if [[ ! "$CORES" =~ ^[0-9]+$ ]] || ((CORES < 2)); then die "At least 2 CPU cores are required."; fi -if [[ ! "$MEMORY_MB" =~ ^[0-9]+$ ]] || ((MEMORY_MB < 2048)); then die "At least 2048 MiB of memory is required."; fi +[[ "$CORES" =~ ^[0-9]+$ ]] && ((CORES >= 2)) || die "At least 2 CPU cores are required." +[[ "$MEMORY_MB" =~ ^[0-9]+$ ]] && ((MEMORY_MB >= 2048)) || die "At least 2048 MiB of memory is required." [[ "$SWAP_MB" =~ ^[0-9]+$ ]] || die "Swap must be a non-negative integer." prompt BRIDGE "Proxmox network bridge" vmbr0 @@ -247,15 +234,11 @@ ip link show "$BRIDGE" >/dev/null 2>&1 || die "Network bridge $BRIDGE does not e prompt NETWORK_MODE "IPv4 mode (dhcp/static)" dhcp NET0="name=eth0,bridge=${BRIDGE},firewall=1,ip6=auto" case "$NETWORK_MODE" in - dhcp) - NET0+=",ip=dhcp" - ;; + dhcp) NET0+=",ip=dhcp" ;; static) prompt IPV4_CIDR "LXC IPv4 address with prefix (for example 192.168.1.50/24)" prompt IPV4_GATEWAY "IPv4 gateway (for example 192.168.1.1)" - if [[ ! "$IPV4_CIDR" =~ ^(.+)/([0-9]|[12][0-9]|3[0-2])$ ]]; then - die "Invalid IPv4 CIDR." - fi + [[ "$IPV4_CIDR" =~ ^(.+)/([0-9]|[12][0-9]|3[0-2])$ ]] || die "Invalid IPv4 CIDR." valid_ipv4 "${BASH_REMATCH[1]}" || die "Invalid IPv4 CIDR." valid_ipv4 "$IPV4_GATEWAY" || die "Invalid IPv4 gateway." NET0+=",ip=${IPV4_CIDR},gw=${IPV4_GATEWAY}" @@ -265,28 +248,19 @@ esac prompt VLAN_TAG "Optional VLAN tag (empty means untagged)" "" if [[ -n "$VLAN_TAG" ]]; then - if [[ ! "$VLAN_TAG" =~ ^[0-9]+$ ]] || ((VLAN_TAG < 1 || VLAN_TAG > 4094)); then - die "VLAN must be between 1 and 4094." - fi + [[ "$VLAN_TAG" =~ ^[0-9]+$ ]] && ((VLAN_TAG >= 1 && VLAN_TAG <= 4094)) || die "VLAN must be between 1 and 4094." NET0+=",tag=${VLAN_TAG}" fi DEFAULT_MEDIA_MODE=none if [[ -d "$DEFAULT_HOST_MEDIA_PATH" ]]; then DEFAULT_MEDIA_TARGET=$(findmnt -T "$DEFAULT_HOST_MEDIA_PATH" -n -o TARGET --first 2>/dev/null || true) - [[ -n "$DEFAULT_MEDIA_TARGET" && "$DEFAULT_MEDIA_TARGET" != "/" ]] && DEFAULT_MEDIA_MODE=host + [[ -n "$DEFAULT_MEDIA_TARGET" && "$DEFAULT_MEDIA_TARGET" != / ]] && DEFAULT_MEDIA_MODE=host fi prompt MEDIA_STORAGE_MODE "Media storage mode (host/proxmox/none)" "$DEFAULT_MEDIA_MODE" -HOST_DATA_PATH="" -HOST_MEDIA_BACKING_TARGET="" -HOST_MEDIA_BACKING_SOURCE="" -HOST_MEDIA_BACKING_FSTYPE="" -DATA_STORAGE="" -DATA_SIZE_GB="" -DATA_BACKUP=no -STORAGE_TOKEN="" - +HOST_DATA_PATH=""; HOST_MEDIA_BACKING_TARGET=""; HOST_MEDIA_BACKING_SOURCE=""; HOST_MEDIA_BACKING_FSTYPE="" +DATA_STORAGE=""; DATA_SIZE_GB=""; DATA_BACKUP=no; STORAGE_TOKEN="" case "$MEDIA_STORAGE_MODE" in host) prompt HOST_DATA_PATH "Existing host media path" "$DEFAULT_HOST_MEDIA_PATH" @@ -297,24 +271,18 @@ case "$MEDIA_STORAGE_MODE" in ;; proxmox) prompt DATA_STORAGE "Media volume storage" "$ROOT_STORAGE" - storage_supports "$DATA_STORAGE" rootdir || - die "Storage $DATA_STORAGE is not active or does not support LXC volumes." + storage_supports "$DATA_STORAGE" rootdir || die "Storage $DATA_STORAGE is not active or does not support LXC volumes." prompt DATA_SIZE_GB "Media volume size in GiB" 500 - if [[ ! "$DATA_SIZE_GB" =~ ^[0-9]+$ ]] || ((DATA_SIZE_GB < 20)); then - die "Media volume must be at least 20 GiB." - fi + [[ "$DATA_SIZE_GB" =~ ^[0-9]+$ ]] && ((DATA_SIZE_GB >= 20)) || die "Media volume must be at least 20 GiB." yes_no DATA_BACKUP "Include the media volume in Proxmox vzdump backups" no ;; - none) - ;; - *) - die "Media storage mode must be host, proxmox or none." - ;; + none) ;; + *) die "Media storage mode must be host, proxmox or none." ;; esac ENABLE_GPU=no -if [[ -e /dev/dri/renderD128 ]]; then - yes_no ENABLE_GPU "Pass Intel/AMD render device to Jellyfin" yes +if [[ -c /dev/dri/renderD128 ]]; then + yes_no ENABLE_GPU "Pass /dev/dri/renderD128 to Jellyfin for hardware transcoding" yes fi TEMPLATE_STORAGE=$(first_storage_for vztmpl) @@ -326,26 +294,21 @@ printf ' New guest: CT %s (%s), unprivileged Debian 13\n' "$CTID" "$HOSTN printf ' Resources: %s cores, %s MiB RAM, %s MiB swap\n' "$CORES" "$MEMORY_MB" "$SWAP_MB" printf ' Root filesystem: %s:%s GiB\n' "$ROOT_STORAGE" "$ROOT_DISK_GB" printf ' Network: %s via %s%s\n' "$NETWORK_MODE" "$BRIDGE" "${VLAN_TAG:+, VLAN $VLAN_TAG}" -printf ' Required device: /dev/net/tun\n' +printf ' VPN device: /dev/net/tun (Gluetun)\n' [[ "$ENABLE_GPU" == yes ]] && printf ' GPU device: /dev/dri/renderD128\n' case "$MEDIA_STORAGE_MODE" in host) printf ' Media storage: host bind mount %s → %s\n' "$HOST_DATA_PATH" "$MEDIA_MOUNTPOINT" - printf ' Backing fs: %s (%s, %s)\n' \ - "$HOST_MEDIA_BACKING_SOURCE" "$HOST_MEDIA_BACKING_FSTYPE" "$HOST_MEDIA_BACKING_TARGET" - printf ' LXC data UID: %s:%s → host %s:%s\n' \ - "$MEDIA_CONTAINER_UID" "$MEDIA_CONTAINER_GID" "$MEDIA_HOST_UID" "$MEDIA_HOST_GID" + printf ' Backing fs: %s (%s, %s)\n' "$HOST_MEDIA_BACKING_SOURCE" "$HOST_MEDIA_BACKING_FSTYPE" "$HOST_MEDIA_BACKING_TARGET" + printf ' LXC data UID: %s:%s → host %s:%s\n' "$MEDIA_CONTAINER_UID" "$MEDIA_CONTAINER_GID" "$MEDIA_HOST_UID" "$MEDIA_HOST_GID" printf ' vzdump media: no (bind mount)\n' ;; proxmox) - printf ' Media storage: %s:%s GiB → %s (vzdump: %s)\n' \ - "$DATA_STORAGE" "$DATA_SIZE_GB" "$MEDIA_MOUNTPOINT" "$DATA_BACKUP" - ;; - none) - printf ' Media storage: LXC root filesystem (no separate media volume)\n' + printf ' Media storage: %s:%s GiB → %s (vzdump: %s)\n' "$DATA_STORAGE" "$DATA_SIZE_GB" "$MEDIA_MOUNTPOINT" "$DATA_BACKUP" ;; + none) printf ' Media storage: LXC root filesystem (no separate media volume)\n' ;; esac -printf ' Proxmox host: no Docker and no media services will be installed here\n\n' +printf ' PVE host: no Docker and no media services installed here\n\n' yes_no CONFIRM "Create this LXC and launch its internal installer" no [[ "$CONFIRM" == yes ]] || die "Cancelled before making changes." @@ -354,10 +317,9 @@ pveam update TEMPLATE_NAME=$(pveam available --section system | awk '$2 ~ /^debian-13-standard_.*_amd64\.tar\.(zst|gz)$/ {print $2}' | sort -V | tail -n1) -[[ -n "$TEMPLATE_NAME" ]] || die "No Debian 13 amd64 standard template was found in the Proxmox appliance catalog." +[[ -n "$TEMPLATE_NAME" ]] || die "No Debian 13 amd64 standard template was found." TEMPLATE_REF="${TEMPLATE_STORAGE}:vztmpl/${TEMPLATE_NAME}" -if ! pveam list "$TEMPLATE_STORAGE" | - awk -v ref="$TEMPLATE_REF" '$1 == ref {found=1} END {exit !found}'; then +if ! pveam list "$TEMPLATE_STORAGE" | awk -v ref="$TEMPLATE_REF" '$1 == ref {found=1} END {exit !found}'; then info "Downloading $TEMPLATE_NAME to $TEMPLATE_STORAGE..." pveam download "$TEMPLATE_STORAGE" "$TEMPLATE_NAME" else @@ -390,11 +352,7 @@ case "$MEDIA_STORAGE_MODE" in ;; proxmox) info "Allocating the media volume..." - if [[ "$DATA_BACKUP" == yes ]]; then - DATA_BACKUP_FLAG=1 - else - DATA_BACKUP_FLAG=0 - fi + [[ "$DATA_BACKUP" == yes ]] && DATA_BACKUP_FLAG=1 || DATA_BACKUP_FLAG=0 pct set "$CTID" --mp0 "${DATA_STORAGE}:${DATA_SIZE_GB},mp=${MEDIA_MOUNTPOINT},backup=${DATA_BACKUP_FLAG}" ;; esac @@ -407,14 +365,13 @@ fi info "Starting CT $CTID..." pct start "$CTID" -info "Waiting for systemd and IPv4 connectivity inside the LXC..." +info "Waiting for systemd, IPv4 connectivity and TUN inside the LXC..." READY=false for ((_attempt = 1; _attempt <= 60; _attempt++)); do if pct exec "$CTID" -- bash -c ' state=$(systemctl is-system-running 2>/dev/null || true) [[ "$state" == running || "$state" == degraded ]] && - ip -4 route show default | grep -q . && - test -c /dev/net/tun + ip -4 route show default | grep -q . && test -c /dev/net/tun ' 2>/dev/null; then READY=true break @@ -428,8 +385,7 @@ if [[ "$MEDIA_STORAGE_MODE" == host ]]; then pct exec "$CTID" -- env EXPECTED_MEDIA_TOKEN="$STORAGE_TOKEN" MEDIA_MOUNTPOINT="$MEDIA_MOUNTPOINT" bash -c ' set -Eeuo pipefail actual=$(cat "$MEDIA_MOUNTPOINT/.media-stack-storage" 2>/dev/null || true) - [[ "$actual" == "$EXPECTED_MEDIA_TOKEN" ]] || - { echo "Expected media filesystem is not mounted at $MEDIA_MOUNTPOINT." >&2; exit 1; } + [[ "$actual" == "$EXPECTED_MEDIA_TOKEN" ]] || { echo "Expected media filesystem is not mounted." >&2; exit 1; } test -d "$MEDIA_MOUNTPOINT/torrents" test -d "$MEDIA_MOUNTPOINT/media" ' @@ -437,12 +393,11 @@ if [[ "$MEDIA_STORAGE_MODE" == host ]]; then fi SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd) -info "Installing the minimal transfer/PTY tools inside CT $CTID..." +info "Installing minimal transfer/PTY tools inside CT $CTID..." pct exec "$CTID" -- bash -c 'apt-get update && apt-get install -y ca-certificates curl util-linux' if [[ -f "$SCRIPT_DIR/install_media.sh" && -f "$SCRIPT_DIR/templates/compose.yaml" ]]; then info "Copying this checked-out project snapshot into the LXC..." - tar -czf "$TEMP_DIR/media-stack-source.tar.gz" \ - -C "$SCRIPT_DIR" \ + tar -czf "$TEMP_DIR/media-stack-source.tar.gz" -C "$SCRIPT_DIR" \ install_media.sh update_stack.sh sync_transmission_port.sh media_stack.sh templates pct push "$CTID" "$TEMP_DIR/media-stack-source.tar.gz" /root/media-stack-source.tar.gz --perms 0600 pct exec "$CTID" -- mkdir -p /root/media-stack-source @@ -451,11 +406,9 @@ if [[ -f "$SCRIPT_DIR/install_media.sh" && -f "$SCRIPT_DIR/templates/compose.yam else info "Downloading one consistent project snapshot inside CT $CTID..." pct exec "$CTID" -- curl --fail --silent --show-error --location --retry 3 \ - "https://github.com/${PROJECT_REPOSITORY}/archive/main.tar.gz" \ - -o /root/media-stack-source.tar.gz + "https://github.com/${PROJECT_REPOSITORY}/archive/main.tar.gz" -o /root/media-stack-source.tar.gz pct exec "$CTID" -- mkdir -p /root/media-stack-source - pct exec "$CTID" -- tar -xzf /root/media-stack-source.tar.gz \ - --strip-components=1 -C /root/media-stack-source + pct exec "$CTID" -- tar -xzf /root/media-stack-source.tar.gz --strip-components=1 -C /root/media-stack-source INSTALLER_PATH=/root/media-stack-source/install_media.sh fi @@ -477,7 +430,7 @@ CT_MAC=$(pct config "$CTID" | sed -n 's/^net0:.*hwaddr=\([^,]*\).*/\1/p') ok "Media Stack is running exclusively inside CT $CTID (${CT_IP:-IP unavailable})." if [[ "$MEDIA_STORAGE_MODE" == host ]]; then ok "Media data is stored on $HOST_DATA_PATH and exposed inside the LXC as $MEDIA_MOUNTPOINT." - info "Docker will refuse to start in CT $CTID if the expected host media filesystem is missing or replaced." + info "Docker will refuse to start if the expected host media filesystem is missing or replaced." fi printf '\nManagement:\n' [[ "$NETWORK_MODE" != dhcp ]] || printf ' DHCP reservation: reserve MAC %s for CT %s\n' "${CT_MAC:-unavailable}" "$CTID" @@ -485,4 +438,4 @@ printf ' Enter LXC: pct enter %s\n' "$CTID" printf ' Stack status: pct exec %s -- media-stack status\n' "$CTID" printf ' Full diagnosis: pct exec %s -- media-stack doctor\n' "$CTID" printf ' Remove protection before intentionally deleting the CT:\n' -printf ' pct set %s --protection 0\n' "$CTID" \ No newline at end of file +printf ' pct set %s --protection 0\n' "$CTID" diff --git a/sync_transmission_port.sh b/sync_transmission_port.sh old mode 100644 new mode 100755 index 1aea71b..409baaf --- a/sync_transmission_port.sh +++ b/sync_transmission_port.sh @@ -1,5 +1,4 @@ #!/usr/bin/env bash - set -Eeuo pipefail umask 077 @@ -14,19 +13,36 @@ flock -n 9 || exit 0 TR_USER_FILE="$STACK_DIR/secrets/transmission_user" TR_PASS_FILE="$STACK_DIR/secrets/transmission_password" [[ -s "$TR_USER_FILE" && -s "$TR_PASS_FILE" ]] || { - echo "Missing Transmission credential files in $STACK_DIR/secrets." >&2 - exit 1 + echo "Missing Transmission credentials." >&2 + exit 1 } TR_USER=$(<"$TR_USER_FILE") TR_PASS=$(<"$TR_PASS_FILE") +cd "$STACK_DIR" + +read_forwarded_port() { + local json port + json=$(docker compose exec -T gluetun wget -qO- -T 5 http://127.0.0.1:8000/v1/portforward 2>/dev/null || true) + if [[ -n "$json" ]]; then + port=$(jq -r '.port // (.ports[0] // empty)' <<<"$json" 2>/dev/null || true) + if [[ "$port" =~ ^[0-9]+$ ]] && ((port >= 1 && port <= 65535)); then + printf '%s' "$port" + return 0 + fi + fi + + # Compatibility fallback for Gluetun v3. The status file is deprecated in v4. + port=$(docker compose exec -T gluetun cat /tmp/gluetun/forwarded_port 2>/dev/null || true) + port=${port//$'\r'/} + port=${port//$'\n'/} + [[ "$port" =~ ^[0-9]+$ ]] && ((port >= 1 && port <= 65535)) || return 1 + printf '%s' "$port" +} -cd "$STACK_DIR" || exit 1 -forwarded_port=$(docker compose exec -T gluetun cat /tmp/gluetun/forwarded_port 2>/dev/null || true) -forwarded_port=${forwarded_port//$'\r'/} -forwarded_port=${forwarded_port//$'\n'/} -if [[ ! "$forwarded_port" =~ ^[0-9]+$ ]] || ((forwarded_port < 1 || forwarded_port > 65535)); then - echo "ProtonVPN has not assigned a valid forwarded port yet; the timer will retry." - exit 0 +forwarded_port=$(read_forwarded_port || true) +if [[ -z "$forwarded_port" ]]; then + echo "ProtonVPN has not assigned a valid forwarded port yet; the timer will retry." + exit 0 fi temp_dir=$(mktemp -d) @@ -34,53 +50,40 @@ trap 'rm -rf -- "$temp_dir"' EXIT headers="$temp_dir/headers" response="$temp_dir/response.json" -# Transmission deliberately answers the first unauthenticated-session request -# with HTTP 409 and returns the session token in a response header. http_code=$(curl --silent --show-error --max-time 10 \ - -u "$TR_USER:$TR_PASS" \ - -D "$headers" \ - -o /dev/null \ - -X POST \ - -w '%{http_code}' \ - "$RPC_URL") + -u "$TR_USER:$TR_PASS" -D "$headers" -o /dev/null -X POST \ + -w '%{http_code}' "$RPC_URL") [[ "$http_code" == 409 || "$http_code" == 200 ]] || { - echo "Transmission RPC returned HTTP $http_code while requesting a session token." >&2 - exit 1 + echo "Transmission RPC returned HTTP $http_code while requesting a session token." >&2 + exit 1 } session_id=$(awk -F ':[[:space:]]*' ' - tolower($1) == "x-transmission-session-id" { - gsub(/\r/, "", $2) - print $2 - } + tolower($1) == "x-transmission-session-id" {gsub(/\r/, "", $2); print $2} ' "$headers" | tail -n1) [[ -n "$session_id" ]] || { - echo "Transmission did not return an RPC session ID." >&2 - exit 1 + echo "Transmission did not return an RPC session ID." >&2 + exit 1 } rpc() { - local payload=$1 - curl --fail --silent --show-error --max-time 10 \ - -u "$TR_USER:$TR_PASS" \ - -H "X-Transmission-Session-Id: $session_id" \ - -H "Content-Type: application/json" \ - --data "$payload" \ - "$RPC_URL" > "$response" - jq -e '.result == "success"' "$response" >/dev/null + local payload=$1 + curl --fail --silent --show-error --max-time 10 \ + -u "$TR_USER:$TR_PASS" \ + -H "X-Transmission-Session-Id: $session_id" \ + -H 'Content-Type: application/json' \ + --data "$payload" "$RPC_URL" >"$response" + jq -e '.result == "success"' "$response" >/dev/null } rpc '{"method":"session-get","arguments":{"fields":["peer-port"]}}' current_port=$(jq -r '.arguments["peer-port"] // empty' "$response") if [[ "$current_port" == "$forwarded_port" ]]; then - echo "Transmission peer port is already synchronized to $forwarded_port." - exit 0 + echo "Transmission peer port is already synchronized to $forwarded_port." + exit 0 fi -payload=$(jq -cn --argjson port "$forwarded_port" '{ - method: "session-set", - arguments: {"peer-port": $port, "peer-port-random-on-start": false} -}') +payload=$(jq -cn --argjson port "$forwarded_port" '{method:"session-set",arguments:{"peer-port":$port,"peer-port-random-on-start":false}}') rpc "$payload" rpc '{"method":"session-get","arguments":{"fields":["peer-port"]}}' jq -e --argjson port "$forwarded_port" '.arguments["peer-port"] == $port' "$response" >/dev/null diff --git a/templates/compose.yaml b/templates/compose.yaml index 8660b38..4f238a2 100644 --- a/templates/compose.yaml +++ b/templates/compose.yaml @@ -15,9 +15,6 @@ x-linuxserver: &linuxserver networks: media: driver: bridge - socket-proxy: - driver: bridge - internal: true secrets: transmission_user: @@ -39,6 +36,7 @@ services: VPN_PORT_FORWARDING: "on" VPN_PORT_FORWARDING_PROVIDER: protonvpn VPN_PORT_FORWARDING_STATUS_FILE: /tmp/gluetun/forwarded_port + HTTP_CONTROL_SERVER_AUTH_CONFIG_FILEPATH: /gluetun/auth/config.toml FIREWALL_INPUT_PORTS: "9091" UPDATER_PERIOD: 480h TZ: ${TZ:?TZ is required} @@ -95,14 +93,12 @@ services: flaresolverr: image: ghcr.io/flaresolverr/flaresolverr:latest - profiles: - - flaresolverr + profiles: [flaresolverr] restart: unless-stopped environment: TZ: ${TZ:?TZ is required} LOG_LEVEL: info - networks: - - media + networks: [media] security_opt: - no-new-privileges:true logging: *default-logging @@ -117,15 +113,10 @@ services: UMASK: "002" volumes: - ./config/prowlarr:/config - networks: - - media + networks: [media] ports: - - target: 9696 - published: "9696" - host_ip: 127.0.0.1 - - target: 9696 - published: "9696" - host_ip: ${LAN_IP:?LAN_IP is required} + - {target: 9696, published: "9696", host_ip: 127.0.0.1} + - {target: 9696, published: "9696", host_ip: "${LAN_IP:?LAN_IP is required}"} healthcheck: test: [CMD-SHELL, "curl -fsS --max-time 5 http://127.0.0.1:9696/ping >/dev/null || exit 1"] start_period: 30s @@ -144,15 +135,10 @@ services: volumes: - ./config/sonarr:/config - ./data:/data - networks: - - media + networks: [media] ports: - - target: 8989 - published: "8989" - host_ip: 127.0.0.1 - - target: 8989 - published: "8989" - host_ip: ${LAN_IP:?LAN_IP is required} + - {target: 8989, published: "8989", host_ip: 127.0.0.1} + - {target: 8989, published: "8989", host_ip: "${LAN_IP:?LAN_IP is required}"} healthcheck: test: [CMD-SHELL, "curl -fsS --max-time 5 http://127.0.0.1:8989/ping >/dev/null || exit 1"] start_period: 30s @@ -171,15 +157,10 @@ services: volumes: - ./config/radarr:/config - ./data:/data - networks: - - media + networks: [media] ports: - - target: 7878 - published: "7878" - host_ip: 127.0.0.1 - - target: 7878 - published: "7878" - host_ip: ${LAN_IP:?LAN_IP is required} + - {target: 7878, published: "7878", host_ip: 127.0.0.1} + - {target: 7878, published: "7878", host_ip: "${LAN_IP:?LAN_IP is required}"} healthcheck: test: [CMD-SHELL, "curl -fsS --max-time 5 http://127.0.0.1:7878/ping >/dev/null || exit 1"] start_period: 30s @@ -198,15 +179,10 @@ services: volumes: - ./config/bazarr:/config - ./data:/data - networks: - - media + networks: [media] ports: - - target: 6767 - published: "6767" - host_ip: 127.0.0.1 - - target: 6767 - published: "6767" - host_ip: ${LAN_IP:?LAN_IP is required} + - {target: 6767, published: "6767", host_ip: 127.0.0.1} + - {target: 6767, published: "6767", host_ip: "${LAN_IP:?LAN_IP is required}"} healthcheck: test: [CMD-SHELL, "curl -fsS --max-time 5 http://127.0.0.1:6767/ >/dev/null || exit 1"] start_period: 45s @@ -225,22 +201,10 @@ services: volumes: - ./config/jellyfin:/config - ./data:/data - networks: - - media + networks: [media] ports: - - target: 8096 - published: "8096" - host_ip: 127.0.0.1 - - target: 8096 - published: "8096" - host_ip: ${LAN_IP:?LAN_IP is required} - labels: - pangolin.public-resources.jellyfin.name: Jellyfin - pangolin.public-resources.jellyfin.full-domain: jellyfin.${PUBLIC_DOMAIN:?PUBLIC_DOMAIN is required} - pangolin.public-resources.jellyfin.mode: http - pangolin.public-resources.jellyfin.targets[0].method: http - pangolin.public-resources.jellyfin.targets[0].hostname: jellyfin - pangolin.public-resources.jellyfin.targets[0].port: "8096" + - {target: 8096, published: "8096", host_ip: 127.0.0.1} + - {target: 8096, published: "8096", host_ip: "${LAN_IP:?LAN_IP is required}"} healthcheck: test: [CMD-SHELL, "curl -fsS --max-time 5 http://127.0.0.1:8096/System/Info/Public >/dev/null || exit 1"] start_period: 45s @@ -257,23 +221,10 @@ services: PORT: "5055" volumes: - ./config/seerr:/app/config - networks: - - media + networks: [media] ports: - - target: 5055 - published: "5055" - host_ip: 127.0.0.1 - - target: 5055 - published: "5055" - host_ip: ${LAN_IP:?LAN_IP is required} - labels: - pangolin.public-resources.seerr.name: Seerr - pangolin.public-resources.seerr.full-domain: seerr.${PUBLIC_DOMAIN:?PUBLIC_DOMAIN is required} - pangolin.public-resources.seerr.mode: http - pangolin.public-resources.seerr.auth.sso-enabled: "true" - pangolin.public-resources.seerr.targets[0].method: http - pangolin.public-resources.seerr.targets[0].hostname: seerr - pangolin.public-resources.seerr.targets[0].port: "5055" + - {target: 5055, published: "5055", host_ip: 127.0.0.1} + - {target: 5055, published: "5055", host_ip: "${LAN_IP:?LAN_IP is required}"} healthcheck: test: [CMD-SHELL, "wget -q --spider http://127.0.0.1:5055/api/v1/settings/public || exit 1"] start_period: 30s @@ -286,57 +237,3 @@ services: security_opt: - no-new-privileges:true logging: *default-logging - - socket-proxy: - image: lscr.io/linuxserver/socket-proxy:latest - profiles: - - pangolin - restart: unless-stopped - environment: - CONTAINERS: "1" - EVENTS: "1" - INFO: "1" - NETWORKS: "1" - PING: "1" - VERSION: "1" - POST: "0" - ALLOW_RESTARTS: "0" - volumes: - - /var/run/docker.sock:/var/run/docker.sock:ro - networks: - - socket-proxy - read_only: true - tmpfs: - - /run:size=16m,mode=0755 - security_opt: - - no-new-privileges:true - logging: *default-logging - - newt: - image: fosrl/newt:latest - profiles: - - pangolin - restart: unless-stopped - depends_on: - - socket-proxy - environment: - CONFIG_FILE: /config/config.json - DOCKER_SOCKET: tcp://socket-proxy:2375 - DOCKER_ENFORCE_NETWORK_VALIDATION: "true" - HEALTH_FILE: /tmp/healthy - volumes: - - ./config/newt:/config - networks: - - media - - socket-proxy - tmpfs: - - /tmp:size=16m,mode=1777 - healthcheck: - test: [CMD-SHELL, "test -f /tmp/healthy"] - start_period: 30s - interval: 20s - timeout: 3s - retries: 3 - security_opt: - - no-new-privileges:true - logging: *default-logging diff --git a/tests/validate.sh b/tests/validate.sh old mode 100644 new mode 100755 index 418da18..e38161d --- a/tests/validate.sh +++ b/tests/validate.sh @@ -1,119 +1,124 @@ #!/usr/bin/env bash - set -Eeuo pipefail REPOSITORY_ROOT=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd) -cd "$REPOSITORY_ROOT" || exit 1 +cd "$REPOSITORY_ROOT" SCRIPTS=( - proxmox_lxc.sh - install_media.sh - media_stack.sh - update_stack.sh - sync_transmission_port.sh + proxmox_lxc.sh + install_media.sh + media_stack.sh + update_stack.sh + sync_transmission_port.sh ) + bash -n "${SCRIPTS[@]}" bash media_stack.sh help >/dev/null -[[ "$(bash media_stack.sh version)" == "media-stack 4.0.0" ]] +[[ "$(bash media_stack.sh version)" == "media-stack 5.0.0" ]] -temp_dir=$(mktemp -d) -trap 'rm -rf -- "$temp_dir"' EXIT -cp templates/*.yaml "$temp_dir/" -mkdir -p "$temp_dir/secrets" +# Infrastructure access belongs outside this repository. Keep the media stack +# focused by allowing only the expected application services. +EXPECTED_SERVICES='bazarr flaresolverr gluetun jellyfin prowlarr radarr seerr sonarr transmission' + +TEMP_DIR=$(mktemp -d) +trap 'rm -rf -- "$TEMP_DIR"' EXIT +cp templates/*.yaml "$TEMP_DIR/" +mkdir -p "$TEMP_DIR/secrets" for secret in transmission_user transmission_password proton_openvpn_user proton_openvpn_password proton_wireguard_private_key; do - printf 'test-value' > "$temp_dir/secrets/$secret" + printf 'test-value' >"$TEMP_DIR/secrets/$secret" done -cat > "$temp_dir/.env" <<'EOF' +cat >"$TEMP_DIR/.env" <<'ENV' PUID='1000' PGID='1000' TZ='Europe/Warsaw' LAN_IP='192.0.2.10' -PUBLIC_DOMAIN='example.com' RENDER_GID='104' -COMPOSE_PROFILES='pangolin,flaresolverr' -EOF +COMPOSE_PROFILES='flaresolverr' +ENV validate_variant() { - local vpn gpu output - local -a files - vpn=$1 - gpu=${2:-no} - output="$temp_dir/${vpn}-${gpu}.json" - files=(-f compose.yaml -f "compose.${vpn}.yaml") - [[ "$gpu" == yes ]] && files+=(-f compose.gpu.yaml) - ( - cd "$temp_dir" || exit 1 - docker compose "${files[@]}" config --quiet - docker compose "${files[@]}" config --format json > "$output" - ) - jq -e . "$output" >/dev/null + local vpn=$1 gpu=${2:-no} output + local -a files=(-f compose.yaml -f "compose.${vpn}.yaml") + [[ "$gpu" == yes ]] && files+=(-f compose.gpu.yaml) + output="$TEMP_DIR/${vpn}-${gpu}.json" + ( + cd "$TEMP_DIR" + docker compose "${files[@]}" config --quiet + docker compose "${files[@]}" config --format json >"$output" + ) + jq -e . "$output" >/dev/null } -validate_variant openvpn yes -validate_variant wireguard no +validate_variant wireguard yes +validate_variant openvpn no + +WG_MODEL="$TEMP_DIR/wireguard-yes.json" +OVPN_MODEL="$TEMP_DIR/openvpn-no.json" + +# Exact service inventory prevents accidental infrastructure creep. +ACTUAL_SERVICES=$(jq -r '.services | keys[]' "$WG_MODEL" | sort | xargs) +[[ "$ACTUAL_SERVICES" == "$EXPECTED_SERVICES" ]] -model="$temp_dir/openvpn-yes.json" -jq -e ' - .services.transmission.network_mode == "service:gluetun" and - .services.gluetun.cap_add == ["NET_ADMIN"] and - .services["socket-proxy"].environment.POST == "0" and - .services["socket-proxy"].read_only == true and - .services.newt.environment.DOCKER_ENFORCE_NETWORK_VALIDATION == "true" and - .services.jellyfin.labels["pangolin.public-resources.jellyfin.mode"] == "http" and - .services.seerr.labels["pangolin.public-resources.seerr.mode"] == "http" and - .services.newt.healthcheck.test[1] == "test -f /tmp/healthy" -' "$model" >/dev/null - -wireguard_model="$temp_dir/wireguard-no.json" jq -e ' - .services.gluetun.environment.WIREGUARD_PRIVATE_KEY_SECRETFILE == "/run/secrets/proton_wireguard_private_key" and - (.services.gluetun.environment | has("WIREGUARD_PRIVATE_KEY") | not) -' "$wireguard_model" >/dev/null + .services.transmission.network_mode == "service:gluetun" and + .services.gluetun.cap_add == ["NET_ADMIN"] and + .services.gluetun.environment.VPN_SERVICE_PROVIDER == "protonvpn" and + .services.gluetun.environment.VPN_PORT_FORWARDING == "on" and + .services.gluetun.environment.HTTP_CONTROL_SERVER_AUTH_CONFIG_FILEPATH == "/gluetun/auth/config.toml" and + .services.jellyfin.devices[0].source == "/dev/dri/renderD128" and + .services.jellyfin.devices[0].target == "/dev/dri/renderD128" +' "$WG_MODEL" >/dev/null +# Secrets must be file-backed rather than interpolated plaintext values. jq -e ' - (.services.newt.environment | has("NEWT_ID") | not) and - (.services.newt.environment | has("NEWT_SECRET") | not) -' "$model" >/dev/null - -# Administrative services must never declare a Pangolin public resource. -for service in transmission radarr sonarr prowlarr bazarr flaresolverr; do - if jq -e --arg service "$service" ' - .services[$service].labels // {} | - keys[]? | - startswith("pangolin.public-resources.") - ' "$model" >/dev/null; then - echo "$service unexpectedly declares a public Pangolin resource" >&2 - exit 1 - fi -done + .services.gluetun.environment.WIREGUARD_PRIVATE_KEY_SECRETFILE == "/run/secrets/proton_wireguard_private_key" and + (.services.gluetun.environment | has("WIREGUARD_PRIVATE_KEY") | not) and + .services.transmission.environment.FILE__USER == "/run/secrets/transmission_user" and + .services.transmission.environment.FILE__PASS == "/run/secrets/transmission_password" and + (.services.transmission.environment | has("USER") | not) and + (.services.transmission.environment | has("PASS") | not) +' "$WG_MODEL" >/dev/null -# VPN and Transmission credentials must be file-backed, not interpolated values. jq -e ' - .services.gluetun.environment.OPENVPN_USER_SECRETFILE == "/run/secrets/proton_openvpn_user" and - .services.gluetun.environment.OPENVPN_PASSWORD_SECRETFILE == "/run/secrets/proton_openvpn_password" and - (.services.gluetun.environment | has("OPENVPN_USER") | not) and - (.services.gluetun.environment | has("OPENVPN_PASSWORD") | not) and - .services.transmission.environment.FILE__PASS == "/run/secrets/transmission_password" and - (.services.transmission.environment | has("PASS") | not) -' "$model" >/dev/null - -# The host provisioner must invoke the LXC installer through pct, never locally. + .services.gluetun.environment.OPENVPN_USER_SECRETFILE == "/run/secrets/proton_openvpn_user" and + .services.gluetun.environment.OPENVPN_PASSWORD_SECRETFILE == "/run/secrets/proton_openvpn_password" and + (.services.gluetun.environment | has("OPENVPN_USER") | not) and + (.services.gluetun.environment | has("OPENVPN_PASSWORD") | not) +' "$OVPN_MODEL" >/dev/null + +# No application should declare public-ingress metadata; exposure is outside this project. +if jq -e '[.services[] | .labels // {} | length] | any(. > 0)' "$WG_MODEL" >/dev/null; then + echo "Unexpected service labels found in media Compose" >&2 + exit 1 +fi + +# Installer defaults and automation contracts. +grep -Fq 'CURRENT_VPN_TYPE=wireguard' install_media.sh +grep -Fq 'prompt ROOT_DISK_GB "Root filesystem size in GiB" 64' proxmox_lxc.sh +grep -Fq 'settings-general-use_sonarr=true' media_stack.sh +grep -Fq 'settings-general-use_radarr=true' media_stack.sh +grep -Fq 'settings-sonarr-ip=sonarr' media_stack.sh +grep -Fq 'settings-radarr-ip=radarr' media_stack.sh +grep -Fq '/v1/portforward' sync_transmission_port.sh +grep -Fq '/tmp/gluetun/forwarded_port' sync_transmission_port.sh +grep -Fq '/usr/lib/jellyfin-ffmpeg/vainfo --display drm --device /dev/dri/renderD128' media_stack.sh + +# Host provisioner must install applications only through pct inside the LXC. grep -Fq 'pct exec "$CTID" -- env MEDIA_STACK_PROXMOX_LAUNCH=1 \' proxmox_lxc.sh grep -Fq 'script --quiet --return --command "bash $INSTALLER_PATH --from-proxmox" /dev/null' proxmox_lxc.sh -grep -Fq 'This installer runs only inside an LXC' install_media.sh -if grep -Eq '^[[:space:]]*(sudo[[:space:]]+)?bash[[:space:]]+"?\$INSTALLER_PATH"?[[:space:]]+--from-proxmox' proxmox_lxc.sh; then - echo "proxmox_lxc.sh contains a local installer invocation" >&2 - exit 1 -fi if grep -Eq '^[[:space:]]*(sudo[[:space:]]+)?docker([[:space:]]|$)' proxmox_lxc.sh; then - echo "proxmox_lxc.sh contains a Docker invocation on the Proxmox host" >&2 - exit 1 + echo "Host provisioner contains a Docker invocation" >&2 + exit 1 fi -if grep -Eq '^[[:space:]]*(sudo[[:space:]]+)?(apt|apt-get|systemctl)([[:space:]]|$)' proxmox_lxc.sh; then - echo "proxmox_lxc.sh contains an OS/service installation command on the Proxmox host" >&2 - exit 1 +# Do not match systemctl text embedded in commands deliberately executed through +# `pct exec` inside the guest. We only prohibit direct host package installation. +if grep -Eq '^[[:space:]]*(sudo[[:space:]]+)?(apt|apt-get)([[:space:]]|$)' proxmox_lxc.sh; then + echo "Host provisioner contains a host package installation command" >&2 + exit 1 fi +# Common files should not accidentally grow executable syntax errors or whitespace damage. git diff --check + echo "All static validation checks passed." diff --git a/update_stack.sh b/update_stack.sh old mode 100644 new mode 100755 index 096690c..b774b6d --- a/update_stack.sh +++ b/update_stack.sh @@ -1,5 +1,4 @@ #!/usr/bin/env bash - set -Eeuo pipefail umask 077 @@ -13,325 +12,199 @@ HEALTH_TIMEOUT_SECONDS=420 mkdir -p "$STATE_DIR" "$BACKUP_DIR" exec 9>"$STATE_DIR/update.lock" flock -n 9 || exit 0 - -cd "$STACK_DIR" || exit 1 +cd "$STACK_DIR" docker compose config --quiet read_env() { - local key=$1 line value - line=$(awk -v key="$key" 'index($0, key "=") == 1 {print; exit}' "$ENV_FILE") - [[ -n "$line" ]] || return 0 - value=${line#*=} - if [[ "$value" == "'"*"'" && ${#value} -ge 2 ]]; then - value=${value:1:${#value}-2} - elif [[ "$value" == '"'*'"' && ${#value} -ge 2 ]]; then - value=${value:1:${#value}-2} - fi - printf '%s' "$value" + local key=$1 line value + line=$(awk -v key="$key" 'index($0,key "=")==1 {print; exit}' "$ENV_FILE") + [[ -n "$line" ]] || return 0 + value=${line#*=} + if [[ "$value" == "'"*"'" && ${#value} -ge 2 ]]; then value=${value:1:${#value}-2}; + elif [[ "$value" == '"'*'"' && ${#value} -ge 2 ]]; then value=${value:1:${#value}-2}; fi + printf '%s' "$value" } -UPDATE_DELAY_DAYS=$(read_env UPDATE_DELAY_DAYS) -UPDATE_DELAY_DAYS=${UPDATE_DELAY_DAYS:-7} +UPDATE_DELAY_DAYS=$(read_env UPDATE_DELAY_DAYS); UPDATE_DELAY_DAYS=${UPDATE_DELAY_DAYS:-7} OFFSITE_BACKUP_DIR=$(read_env OFFSITE_BACKUP_DIR) OFFSITE_BACKUP_SOURCE=$(read_env OFFSITE_BACKUP_SOURCE) OFFSITE_BACKUP_MOUNTPOINT=$(read_env OFFSITE_BACKUP_MOUNTPOINT) -[[ "$UPDATE_DELAY_DAYS" =~ ^[0-9]+$ ]] || { - echo "UPDATE_DELAY_DAYS must be a non-negative integer." >&2 - exit 1 -} +[[ "$UPDATE_DELAY_DAYS" =~ ^[0-9]+$ ]] || { echo "UPDATE_DELAY_DAYS must be a non-negative integer" >&2; exit 1; } validate_offsite_mount() { - local current_source current_target - [[ -n "$OFFSITE_BACKUP_DIR" ]] || return 0 - [[ -d "$OFFSITE_BACKUP_DIR" && -w "$OFFSITE_BACKUP_DIR" ]] || { - echo "External backup directory is unavailable or not writable: $OFFSITE_BACKUP_DIR" >&2 - return 1 - } - read -r current_source current_target < <(findmnt -T "$OFFSITE_BACKUP_DIR" -n -o SOURCE,TARGET --first) - [[ "$current_source" == "$OFFSITE_BACKUP_SOURCE" && "$current_target" == "$OFFSITE_BACKUP_MOUNTPOINT" ]] || { - echo "External backup mount identity changed: expected $OFFSITE_BACKUP_SOURCE on $OFFSITE_BACKUP_MOUNTPOINT." >&2 - return 1 - } + local current_source current_target + [[ -n "$OFFSITE_BACKUP_DIR" ]] || return 0 + [[ -d "$OFFSITE_BACKUP_DIR" && -w "$OFFSITE_BACKUP_DIR" ]] || { echo "External backup directory unavailable: $OFFSITE_BACKUP_DIR" >&2; return 1; } + read -r current_source current_target < <(findmnt -T "$OFFSITE_BACKUP_DIR" -n -o SOURCE,TARGET --first) + [[ "$current_source" == "$OFFSITE_BACKUP_SOURCE" && "$current_target" == "$OFFSITE_BACKUP_MOUNTPOINT" ]] || { + echo "External backup mount identity changed" >&2; return 1; + } } validate_offsite_mount -TR_USER_FILE="$STACK_DIR/secrets/transmission_user" -TR_PASS_FILE="$STACK_DIR/secrets/transmission_password" -[[ -s "$TR_USER_FILE" && -s "$TR_PASS_FILE" ]] || { - echo "Transmission credential files are missing." >&2 - exit 1 -} -TR_USER=$(<"$TR_USER_FILE") -TR_PASS=$(<"$TR_PASS_FILE") +TR_USER=$(<"$STACK_DIR/secrets/transmission_user") +TR_PASS=$(<"$STACK_DIR/secrets/transmission_password") +DELAY_SECONDS=$((UPDATE_DELAY_DAYS*86400)); NOW=$(date +%s) -DELAY_SECONDS=$((UPDATE_DELAY_DAYS * 86400)) -NOW=$(date +%s) - -UPDATE_GROUPS=(vpn ingress flaresolverr prowlarr sonarr radarr bazarr jellyfin seerr) +UPDATE_GROUPS=(vpn flaresolverr prowlarr sonarr radarr bazarr jellyfin seerr) declare -A GROUP_SERVICES=( - [vpn]="gluetun transmission" - [ingress]="socket-proxy newt" - [flaresolverr]="flaresolverr" - [prowlarr]="prowlarr" - [sonarr]="sonarr" - [radarr]="radarr" - [bazarr]="bazarr" - [jellyfin]="jellyfin" - [seerr]="seerr" + [vpn]="gluetun transmission" + [flaresolverr]="flaresolverr" + [prowlarr]="prowlarr" + [sonarr]="sonarr" + [radarr]="radarr" + [bazarr]="bazarr" + [jellyfin]="jellyfin" + [seerr]="seerr" ) mapfile -t SERVICES < <(docker compose config --services) declare -A SERVICE_EXISTS RUNNING_IMAGE IMAGE_REF CANDIDATE_IMAGE CANDIDATE_MATURE for service in "${SERVICES[@]}"; do SERVICE_EXISTS[$service]=true; done - for service in "${SERVICES[@]}"; do - container_id=$(docker compose ps -q "$service") - [[ -n "$container_id" ]] || { - echo "Service $service is not running; start the complete active stack before updating." >&2 - exit 1 - } - RUNNING_IMAGE[$service]=$(docker inspect --format '{{.Image}}' "$container_id") - IMAGE_REF[$service]=$(docker inspect --format '{{.Config.Image}}' "$container_id") + id=$(docker compose ps -q "$service") + [[ -n "$id" ]] || { echo "Service $service is not running" >&2; exit 1; } + RUNNING_IMAGE[$service]=$(docker inspect --format '{{.Image}}' "$id") + IMAGE_REF[$service]=$(docker inspect --format '{{.Config.Image}}' "$id") done restore_running_tags() { - local service failed=0 - for service in "${SERVICES[@]}"; do - docker image tag "${RUNNING_IMAGE[$service]}" "${IMAGE_REF[$service]}" || failed=1 - done - return "$failed" -} - -abort_before_deployment() { - local status=${1:-1} - trap - ERR INT TERM - set +e - restore_running_tags - echo "Update check was interrupted; image tags were restored to the running versions." >&2 - exit "$status" + local service failed=0 + for service in "${SERVICES[@]}"; do docker image tag "${RUNNING_IMAGE[$service]}" "${IMAGE_REF[$service]}" || failed=1; done + return "$failed" } - +abort_before_deployment() { local status=${1:-1}; trap - ERR INT TERM; set +e; restore_running_tags; exit "$status"; } trap 'abort_before_deployment $?' ERR trap 'abort_before_deployment 130' INT TERM -# Pulling changes local tag pointers but does not modify running containers. docker compose pull - for service in "${SERVICES[@]}"; do - local_image=$(docker image inspect --format '{{.Id}}' "${IMAGE_REF[$service]}" 2>/dev/null || true) - [[ -n "$local_image" ]] || continue - state_file="$STATE_DIR/${service}.candidate" - - if [[ "$local_image" == "${RUNNING_IMAGE[$service]}" ]]; then - rm -f "$state_file" - continue - fi - - CANDIDATE_IMAGE[$service]=$local_image - first_seen=$NOW - previous_image="" - if [[ -f "$state_file" ]]; then - read -r previous_image first_seen < "$state_file" || true - fi - if [[ "$previous_image" != "$local_image" || ! "$first_seen" =~ ^[0-9]+$ ]]; then - first_seen=$NOW - temp_state=$(mktemp "$STATE_DIR/.candidate.XXXXXX") - printf '%s %s\n' "$local_image" "$first_seen" > "$temp_state" - mv "$temp_state" "$state_file" - fi - if ((NOW - first_seen >= DELAY_SECONDS)); then - CANDIDATE_MATURE[$service]=true - else - CANDIDATE_MATURE[$service]=false - fi + local_image=$(docker image inspect --format '{{.Id}}' "${IMAGE_REF[$service]}" 2>/dev/null || true) + [[ -n "$local_image" ]] || continue + state_file="$STATE_DIR/${service}.candidate" + if [[ "$local_image" == "${RUNNING_IMAGE[$service]}" ]]; then rm -f "$state_file"; continue; fi + CANDIDATE_IMAGE[$service]=$local_image + first_seen=$NOW; previous_image="" + if [[ -f "$state_file" ]]; then read -r previous_image first_seen <"$state_file" || true; fi + if [[ "$previous_image" != "$local_image" || ! "$first_seen" =~ ^[0-9]+$ ]]; then + first_seen=$NOW; tmp=$(mktemp "$STATE_DIR/.candidate.XXXXXX"); printf '%s %s\n' "$local_image" "$first_seen" >"$tmp"; mv "$tmp" "$state_file" + fi + if ((NOW-first_seen >= DELAY_SECONDS)); then CANDIDATE_MATURE[$service]=true; else CANDIDATE_MATURE[$service]=false; fi done - -# A pulled tag must never remain pointed at an immature candidate: an unrelated -# manual `docker compose up` would otherwise bypass the maturation delay. restore_running_tags trap - ERR INT TERM SELECTED_SERVICES=() for group in "${UPDATE_GROUPS[@]}"; do - has_candidate=false - group_mature=true - read -r -a group_services <<< "${GROUP_SERVICES[$group]}" - for service in "${group_services[@]}"; do - [[ "${SERVICE_EXISTS[$service]:-false}" == true ]] || continue - if [[ -n "${CANDIDATE_IMAGE[$service]:-}" ]]; then - has_candidate=true - [[ "${CANDIDATE_MATURE[$service]}" == true ]] || group_mature=false - fi - done - if $has_candidate && $group_mature; then - for service in "${group_services[@]}"; do - [[ "${SERVICE_EXISTS[$service]:-false}" == true ]] || continue - SELECTED_SERVICES+=("$service") - done - fi + has_candidate=false; group_mature=true; read -r -a group_services <<<"${GROUP_SERVICES[$group]}" + for service in "${group_services[@]}"; do + [[ "${SERVICE_EXISTS[$service]:-false}" == true ]] || continue + if [[ -n "${CANDIDATE_IMAGE[$service]:-}" ]]; then has_candidate=true; [[ "${CANDIDATE_MATURE[$service]}" == true ]] || group_mature=false; fi + done + if $has_candidate && $group_mature; then + for service in "${group_services[@]}"; do [[ "${SERVICE_EXISTS[$service]:-false}" == true ]] && SELECTED_SERVICES+=("$service"); done + fi done - ((${#SELECTED_SERVICES[@]} > 0)) || exit 0 timestamp=$(date +%Y%m%d-%H%M%S) backup="$BACKUP_DIR/media-stack-$timestamp.tar.gz" -partial_backup="$BACKUP_DIR/.media-stack-$timestamp.tar.gz.partial" +partial="$BACKUP_DIR/.media-stack-$timestamp.tar.gz.partial" rollback_file="$STATE_DIR/rollback-$timestamp.tsv" - for service in "${SERVICES[@]}"; do - rollback_tag="media-stack-rollback/${service}:${timestamp}" - docker image tag "${RUNNING_IMAGE[$service]}" "$rollback_tag" - printf '%s\t%s\t%s\n' "$service" "${IMAGE_REF[$service]}" "${RUNNING_IMAGE[$service]}" >> "$rollback_file" + docker image tag "${RUNNING_IMAGE[$service]}" "media-stack-rollback/${service}:${timestamp}" + printf '%s\t%s\t%s\n' "$service" "${IMAGE_REF[$service]}" "${RUNNING_IMAGE[$service]}" >>"$rollback_file" done prune_artifacts() { - local service - for service in "${SERVICES[@]}"; do - mapfile -t tags < <(docker images "media-stack-rollback/$service" --format '{{.Repository}}:{{.Tag}}' | sort -r) - if ((${#tags[@]} > 2)); then - docker image rm "${tags[@]:2}" >/dev/null 2>&1 || true - fi - done - - mapfile -t backups < <(find "$BACKUP_DIR" -maxdepth 1 -type f -name 'media-stack-*.tar.gz' -printf '%T@ %p\n' | sort -nr | cut -d' ' -f2-) - if ((${#backups[@]} > 5)); then - rm -f -- "${backups[@]:5}" - fi - - if [[ -n "$OFFSITE_BACKUP_DIR" ]] && validate_offsite_mount; then - mapfile -t offsite_backups < <(find "$OFFSITE_BACKUP_DIR" -maxdepth 1 -type f -name 'media-stack-*.tar.gz' -printf '%T@ %p\n' | sort -nr | cut -d' ' -f2-) - if ((${#offsite_backups[@]} > 10)); then - rm -f -- "${offsite_backups[@]:10}" - fi - fi + local service + for service in "${SERVICES[@]}"; do + mapfile -t tags < <(docker images "media-stack-rollback/$service" --format '{{.Repository}}:{{.Tag}}' | sort -r) + ((${#tags[@]} <= 2)) || docker image rm "${tags[@]:2}" >/dev/null 2>&1 || true + done + mapfile -t backups < <(find "$BACKUP_DIR" -maxdepth 1 -type f -name 'media-stack-*.tar.gz' -printf '%T@ %p\n' | sort -nr | cut -d' ' -f2-) + ((${#backups[@]} <= 5)) || rm -f -- "${backups[@]:5}" + if [[ -n "$OFFSITE_BACKUP_DIR" ]] && validate_offsite_mount; then + mapfile -t offsite < <(find "$OFFSITE_BACKUP_DIR" -maxdepth 1 -type f -name 'media-stack-*.tar.gz' -printf '%T@ %p\n' | sort -nr | cut -d' ' -f2-) + ((${#offsite[@]} <= 10)) || rm -f -- "${offsite[@]:10}" + fi } rollback() { - local status=${1:-1} - trap - ERR INT TERM - set +e - echo "Update failed; restoring the previous images and configuration." >&2 - docker compose stop --timeout 60 - if [[ -s "$backup" ]] && tar -tzf "$backup" >/dev/null 2>&1; then - if [[ -d config ]]; then - mv config "config.failed-$timestamp" - fi - tar -xzf "$backup" -C "$STACK_DIR" - elif [[ -e "$partial_backup" ]]; then - rm -f "$partial_backup" - echo "The candidate was not started, so the existing configuration is being preserved." >&2 - else - echo "No valid backup archive exists; preserving the current configuration." >&2 - fi - while IFS=$'\t' read -r _service image_ref old_image; do - docker image tag "$old_image" "$image_ref" - done < "$rollback_file" - docker compose up -d --remove-orphans --force-recreate - for service in "${SELECTED_SERVICES[@]}"; do - if [[ -n "${CANDIDATE_IMAGE[$service]:-}" ]]; then - printf '%s %s\n' "${CANDIDATE_IMAGE[$service]}" "$(date +%s)" > "$STATE_DIR/${service}.candidate" - fi - done - prune_artifacts - exit "$status" + local status=${1:-1}; trap - ERR INT TERM; set +e + echo "Update failed; rolling back" >&2 + docker compose stop --timeout 60 + if [[ -s "$backup" ]] && tar -tzf "$backup" >/dev/null 2>&1; then + [[ ! -d config ]] || mv config "config.failed-$timestamp" + tar -xzf "$backup" -C "$STACK_DIR" + else + rm -f "$partial" + fi + while IFS=$'\t' read -r _ image_ref old_image; do docker image tag "$old_image" "$image_ref"; done <"$rollback_file" + docker compose up -d --remove-orphans --force-recreate + for service in "${SELECTED_SERVICES[@]}"; do [[ -z "${CANDIDATE_IMAGE[$service]:-}" ]] || printf '%s %s\n' "${CANDIDATE_IMAGE[$service]}" "$(date +%s)" >"$STATE_DIR/${service}.candidate"; done + prune_artifacts + exit "$status" } trap rollback ERR trap 'rollback 130' INT TERM docker compose stop --timeout 60 -backup_items=(config secrets .env compose.yaml compose.openvpn.yaml compose.wireguard.yaml compose.gpu.yaml important_info.md update_stack.sh sync_transmission_port.sh media_stack.sh) -existing_backup_items=() -for item in "${backup_items[@]}"; do - [[ -e "$item" ]] && existing_backup_items+=("$item") -done -tar -czf "$partial_backup" "${existing_backup_items[@]}" -tar -tzf "$partial_backup" >/dev/null -mv "$partial_backup" "$backup" -if [[ -n "$OFFSITE_BACKUP_DIR" ]]; then - validate_offsite_mount - cp -a "$backup" "$OFFSITE_BACKUP_DIR/" -fi - -# Point only mature, selected references at their captured candidate IDs. -for service in "${SELECTED_SERVICES[@]}"; do - if [[ -n "${CANDIDATE_IMAGE[$service]:-}" ]]; then - docker image tag "${CANDIDATE_IMAGE[$service]}" "${IMAGE_REF[$service]}" - fi -done +items=(config secrets .env compose.yaml compose.openvpn.yaml compose.wireguard.yaml compose.gpu.yaml important_info.md update_stack.sh sync_transmission_port.sh media_stack.sh) +existing=(); for item in "${items[@]}"; do [[ -e "$item" ]] && existing+=("$item"); done +tar -czf "$partial" "${existing[@]}"; tar -tzf "$partial" >/dev/null; mv "$partial" "$backup" +if [[ -n "$OFFSITE_BACKUP_DIR" ]]; then validate_offsite_mount; cp -a "$backup" "$OFFSITE_BACKUP_DIR/"; fi +for service in "${SELECTED_SERVICES[@]}"; do [[ -z "${CANDIDATE_IMAGE[$service]:-}" ]] || docker image tag "${CANDIDATE_IMAGE[$service]}" "${IMAGE_REF[$service]}"; done docker compose up -d --force-recreate "${SELECTED_SERVICES[@]}" docker compose start declare -A LAST_RESTARTS -for service in "${SERVICES[@]}"; do - container_id=$(docker compose ps -q "$service") - LAST_RESTARTS[$service]=$(docker inspect --format '{{.RestartCount}}' "$container_id") -done +for service in "${SERVICES[@]}"; do id=$(docker compose ps -q "$service"); LAST_RESTARTS[$service]=$(docker inspect --format '{{.RestartCount}}' "$id"); done http_probe() { - case "$1" in - jellyfin) curl -fsS --max-time 5 http://127.0.0.1:8096/System/Info/Public >/dev/null ;; - seerr) curl -fsS --max-time 5 http://127.0.0.1:5055/api/v1/settings/public >/dev/null ;; - transmission) curl -fsS --max-time 5 -u "$TR_USER:$TR_PASS" http://127.0.0.1:9091/transmission/web/ >/dev/null ;; - radarr) curl -fsS --max-time 5 http://127.0.0.1:7878/ping >/dev/null ;; - sonarr) curl -fsS --max-time 5 http://127.0.0.1:8989/ping >/dev/null ;; - prowlarr) curl -fsS --max-time 5 http://127.0.0.1:9696/ping >/dev/null ;; - bazarr) curl -fsS --max-time 5 http://127.0.0.1:6767/ >/dev/null ;; - esac + case "$1" in + jellyfin) curl -fsS --max-time 5 http://127.0.0.1:8096/System/Info/Public >/dev/null ;; + seerr) curl -fsS --max-time 5 http://127.0.0.1:5055/api/v1/settings/public >/dev/null ;; + transmission) curl -fsS --max-time 5 -u "$TR_USER:$TR_PASS" http://127.0.0.1:9091/transmission/web/ >/dev/null ;; + radarr) curl -fsS --max-time 5 http://127.0.0.1:7878/ping >/dev/null ;; + sonarr) curl -fsS --max-time 5 http://127.0.0.1:8989/ping >/dev/null ;; + prowlarr) curl -fsS --max-time 5 http://127.0.0.1:9696/ping >/dev/null ;; + bazarr) curl -fsS --max-time 5 http://127.0.0.1:6767/ >/dev/null ;; + *) true ;; + esac } -stable_since=0 -deadline=$(($(date +%s) + HEALTH_TIMEOUT_SECONDS)) -while (($(date +%s) < deadline)); do - healthy=true - for service in "${SERVICES[@]}"; do - container_id=$(docker compose ps -q "$service") - if [[ -z "$container_id" ]]; then - healthy=false - break - fi - status=$(docker inspect --format '{{.State.Status}}' "$container_id") - health=$(docker inspect --format '{{if .State.Health}}{{.State.Health.Status}}{{else}}none{{end}}' "$container_id") - restarts=$(docker inspect --format '{{.RestartCount}}' "$container_id") - if [[ "$status" != running || ("$health" != none && "$health" != healthy) ]]; then - healthy=false - break - fi - if [[ "$restarts" != "${LAST_RESTARTS[$service]}" ]]; then - LAST_RESTARTS[$service]=$restarts - healthy=false - fi - if ! http_probe "$service"; then - healthy=false - fi - done - - forwarded_port=$(docker compose exec -T gluetun cat /tmp/gluetun/forwarded_port 2>/dev/null || true) - forwarded_port=${forwarded_port//$'\n'/} - if [[ ! "$forwarded_port" =~ ^[0-9]+$ ]] || ((forwarded_port < 1 || forwarded_port > 65535)); then - healthy=false - fi +read_forwarded_port() { + local json port + json=$(docker compose exec -T gluetun wget -qO- -T 5 http://127.0.0.1:8000/v1/portforward 2>/dev/null || true) + port=$(jq -r '.port // (.ports[0] // empty)' <<<"$json" 2>/dev/null || true) + if [[ "$port" =~ ^[0-9]+$ ]] && ((port>=1 && port<=65535)); then printf '%s' "$port"; return 0; fi + port=$(docker compose exec -T gluetun cat /tmp/gluetun/forwarded_port 2>/dev/null || true); port=${port//$'\n'/} + [[ "$port" =~ ^[0-9]+$ ]] && ((port>=1 && port<=65535)) || return 1; printf '%s' "$port" +} - if $healthy; then - ((stable_since > 0)) || stable_since=$(date +%s) - if (($(date +%s) - stable_since >= STABILITY_SECONDS)); then - break - fi - else - stable_since=0 - fi - sleep 10 +stable_since=0; deadline=$(($(date +%s)+HEALTH_TIMEOUT_SECONDS)) +while (($(date +%s)/dev/null || healthy=false + if $healthy; then + ((stable_since>0)) || stable_since=$(date +%s) + if (($(date +%s)-stable_since >= STABILITY_SECONDS)); then break; fi + else stable_since=0; fi + sleep 10 done -((stable_since > 0 && $(date +%s) - stable_since >= STABILITY_SECONDS)) || { - echo "The updated stack did not remain healthy for ${STABILITY_SECONDS}s." >&2 - false -} +((stable_since>0 && $(date +%s)-stable_since >= STABILITY_SECONDS)) || { echo "Updated stack did not remain healthy" >&2; false; } trap - ERR INT TERM -for service in "${SELECTED_SERVICES[@]}"; do - rm -f "$STATE_DIR/${service}.candidate" -done +for service in "${SELECTED_SERVICES[@]}"; do rm -f "$STATE_DIR/${service}.candidate"; done rm -f "$rollback_file" prune_artifacts - echo "Media Stack updated successfully: ${SELECTED_SERVICES[*]}"