frankbook-pro: *arr stack + qbittorrent quadlets inside podman machine

Seven units installed INSIDE the Mac VM (/home/core/.config/containers/
systemd) by a new deploy_frankbook_stack handler: gluetun (ProtonVPN
WireGuard, env-file credentials, publishes qbit's 8080/6881), qbittorrent
(Network=gluetun.container, verbatim /Volumes data roots, first-boot
config seed with fresh machine-local WebUI password and the Finished
Torrents category), and prowlarr/sonarr/radarr/lidarr/readarr (grab-only,
config migrated from dankserver at provisioning, readarr pinned to
amd64-1.0.980). deploy.sh routes the new target through the ssh-config
alias with REMOTE_SHELL=/usr/local/bin/bash (macOS bash 3.2 lacks
associative arrays); the planner learns FRANKBOOK_SERVICES and the
gluetun->qbittorrent netns pairing; new seam test pins the contract.
This commit is contained in:
Frank committed 2026-09-01 14:10:23 -07:00
1 parent 4d5bea42e0
commit 949f68e2b5
13 files changed
+516 -14

No files matched your search

@@ -0,0 +1,43 @@
# Quadlet unit: Gluetun VPN tunnel in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/gluetun.container
# (installed by the frankbook-pro handler in scripts/deploy-remote.sh —
# install_quadlet targets the Linux hosts' systemctl --user, not the VM).
#
# WireGuard tunnel to ProtonVPN. qBittorrent shares this container's network
# namespace (Network=gluetun.container) so torrent egress never touches the
# residential IP. qBittorrent's WebUI and BitTorrent ports publish HERE — a
# netns-sharer publishes no ports of its own (same invariant as the dankclaw
# searxng/gluetun pair). Credentials live in
# /home/core/Containers/gluetun/env inside the VM (mode 0600, never
# committed); the private key is Mac-tunnel-specific and MUST NOT be copied
# from dankclaw — one WireGuard peer key cannot serve two machines at once.
[Unit]
Description=Gluetun VPN tunnel (FrankBook-Pro podman machine)
[Container]
ContainerName=gluetun
Image=docker.io/qmcgaw/gluetun:latest
AddCapability=NET_ADMIN
AddDevice=/dev/net/tun:/dev/net/tun
Environment=VPN_SERVICE_PROVIDER=${VPN_SERVICE_PROVIDER}
Environment=VPN_TYPE=${VPN_TYPE}
Environment=WIREGUARD_PRIVATE_KEY=${WIREGUARD_PRIVATE_KEY}
Environment=WIREGUARD_ADDRESSES=${WIREGUARD_ADDRESSES}
Environment=WIREGUARD_PUBLIC_KEY=${WIREGUARD_PUBLIC_KEY}
Environment=WIREGUARD_ENDPOINT_IP=${WIREGUARD_ENDPOINT_IP}
Environment=WIREGUARD_ENDPOINT_PORT=${WIREGUARD_ENDPOINT_PORT}
Environment=WIREGUARD_ALLOWED_IPS=${WIREGUARD_ALLOWED_IPS}
Environment=WIREGUARD_PERSISTENT_KEEPALIVE_INTERVAL=${WIREGUARD_PERSISTENT_KEEPALIVE_INTERVAL}
PublishPort=8080:8080
PublishPort=6881:6881
PublishPort=6881:6881/udp
[Service]
EnvironmentFile=/home/core/Containers/gluetun/env
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target
@@ -0,0 +1,26 @@
# Quadlet unit: Lidarr in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/lidarr.container
#
# Grab-only: no media binds; config migrated from dankserver's retired
# bare container.
[Unit]
Description=Lidarr (FrankBook-Pro)
[Container]
ContainerName=lidarr
Image=lscr.io/linuxserver/lidarr:latest
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/lidarr-data:/config
PublishPort=8686:8686
[Service]
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target
@@ -0,0 +1,33 @@
# Quadlet unit: Prowlarr in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/prowlarr.container
#
# Arr on the Mac is grab-only: indexer + app-sync management lives here, the
# arrs never auto-import media (the user reviews completed torrents in
# /Volumes/COMPLETE/"Finished Torrents" and moves files manually into the
# library, which lives on dankserver's entropy disk).
#
# Config is migrated from dankserver's retired bare container
# (tar-archived first, per the Phase 4 cutover note) — indexers and app
# settings survive; stale host pointers (old qbit at 192.168.0.235:8080)
# are re-pointed to the Mac's qbit via its API after first boot.
[Unit]
Description=Prowlarr (FrankBook-Pro)
[Container]
ContainerName=prowlarr
Image=lscr.io/linuxserver/prowlarr:latest
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/prowlarr-data:/config
PublishPort=9696:9696
[Service]
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target
@@ -0,0 +1,43 @@
# Quadlet unit: qBittorrent in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/qbittorrent.container
#
# Joins gluetun's network namespace (Network=gluetun.container) so all
# BitTorrent egress exits the WireGuard tunnel. It publishes NO port of its
# own — WebUI 8080 and torrent port 6881 publish on the gluetun unit.
#
# Data layout (plan-locked, verbatim paths):
# /config <- /Volumes/COMPLETE/qbittorrent-data (durable config)
# /Volumes/COMPLETE + /Volumes/INCOMPLETE same-path virtiofs passthroughs —
# the seeded qBittorrent.conf references those literal paths:
# Session\DefaultSavePath=/Volumes/COMPLETE
# Session\TempPath=/Volumes/INCOMPLETE/incomplete (in-progress disk)
# category "Finished Torrents" -> /Volumes/COMPLETE/Finished Torrents
# (the human review dir; nothing automated ever writes to entropy).
#
# WebUI password: generated fresh at provisioning by the deploy handler,
# stored machine-local only (conf + /home/core/Containers/qbittorrent/env).
[Unit]
Description=qBittorrent behind gluetun (FrankBook-Pro)
Wants=gluetun.service
After=gluetun.service
[Container]
ContainerName=qbittorrent
Network=gluetun.container
Image=lscr.io/linuxserver/qbittorrent:latest
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/qbittorrent-data:/config
Volume=/Volumes/COMPLETE:/Volumes/COMPLETE
Volume=/Volumes/INCOMPLETE:/Volumes/INCOMPLETE
[Service]
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target
@@ -0,0 +1,26 @@
# Quadlet unit: Radarr in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/radarr.container
#
# Grab-only: no media binds; config migrated from dankserver's retired
# bare container.
[Unit]
Description=Radarr (FrankBook-Pro)
[Container]
ContainerName=radarr
Image=lscr.io/linuxserver/radarr:latest
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/radarr-data:/config
PublishPort=7878:7878
[Service]
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target
@@ -0,0 +1,30 @@
# Quadlet unit: Readarr in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/readarr.container
#
# Grab-only: no media binds; config migrated from dankserver's retired
# bare container.
#
# Image pinned to amd64-1.0.980 (per project image-pin policy — same tag the
# dankserver compose ran): `latest` historically shipped an amd64-only build
# of a broken 1.x nightly for Readarr; the pin avoids surprises.
[Unit]
Description=Readarr (FrankBook-Pro)
[Container]
ContainerName=readarr
Image=lscr.io/linuxserver/readarr:amd64-1.0.980
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/readarr-data:/config
PublishPort=8787:8787
[Service]
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target
@@ -0,0 +1,27 @@
# Quadlet unit: Sonarr in FrankBook-Pro's podman machine.
#
# Install path is INSIDE the machine VM:
# /home/core/.config/containers/systemd/sonarr.container
#
# Grab-only: no media binds (the TV library lives on dankserver's entropy
# disk, which the Mac never mounts); config migrated from dankserver's
# retired bare container.
[Unit]
Description=Sonarr (FrankBook-Pro)
[Container]
ContainerName=sonarr
Image=lscr.io/linuxserver/sonarr:latest
Environment=PUID=0
Environment=PGID=0
Environment=TZ=America/Los_Angeles
Environment=UMASK_SET=022
Volume=/Volumes/COMPLETE/sonarr-data:/config
PublishPort=8989:8989
[Service]
TimeoutStartSec=900
Restart=always
[Install]
WantedBy=default.target