Compare commits

..

11 Commits

Author SHA1 Message Date
Adyrem c707a7cceb Add Anki route and fix Jellyfin cache disk exhaustion
Ansible Lint / lint (push) Successful in 6s
- Add adyrem.duckdns.org/Anki → claude-code VM:4002 via Traefik
- Add anki.homelab DNS entry to Pi-hole
- Mount Jellyfin transcode cache to /media/transcodes (HDD) instead of
  anonymous Docker volume on root disk; prevents root disk from filling up

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 15:02:21 +02:00
Adyrem bc838dfcb6 Add jellyfin media stack with full service automation
Ansible Lint / lint (push) Successful in 7s
- New jellyfin Ansible role: Docker stack (Jellyfin, qBittorrent, Radarr,
  Sonarr, Prowlarr, FlareSolverr, Jellyseerr) with NVIDIA GPU passthrough
- configure_services.yml automates download clients, root folders, Prowlarr
  indexers/apps, qBittorrent credential pre-seeding, and Jellyseerr setup
- Fix TPB Cardigann season search: apibay.org returns 0 for season-level
  queries (e.g. the.boys.s05); patch strips season/ep from tv-search params
  and locks the definition file read-only to survive Prowlarr refreshes
- Fix Pi-hole update_hosts.py regex: use re.DOTALL + count=1 to handle
  multi-line arrays without overwriting the DHCP section
- Add phone WireGuard peer, devbox Traefik/DNS entries, TLS cert plumbing,
  firewall rule for Traefik IP to Proxmox web UI

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 18:31:30 +02:00
Adyrem f4c1651d17 Fix NVIDIA installer task; remove jellyfin-tools reference file
Ansible Lint / lint (push) Successful in 4s
- Switch NVIDIA installer copy to get_url so the LXC downloads it
  directly from NVIDIA's servers rather than expecting the file on the
  Ansible controller
- Remove jellyfin-tools (original compose reference from upstream);
  the Ansible template is now the authoritative compose file

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 13:41:44 +02:00
Adyrem 3bb01ddaaf Add Jellyfin media stack (LXC 106, NVIDIA GTX 1060)
- New Ansible role: jellyfin — Docker + nvidia-container-toolkit setup,
  full *arr stack compose file (Jellyfin, qBittorrent, Radarr, Sonarr,
  Prowlarr, FlareSolverr, Jellyseerr), systemd service for auto-start
- New playbook: jellyfin.yml targeting media_servers group
- Inventory: add media LXC (10.10.1.50) to media_servers group
- Traefik: add internal .homelab routes for all 6 media services
- Pi-hole: add DNS records for all 6 media services → Traefik
- network-interfaces: DNAT port 6881 TCP+UDP → 10.10.1.50 for BitTorrent
- homelab-requirements.md: document full Jellyfin stack requirements
  including NVIDIA GTX 1060 passthrough approach and driver notes
- jellyfin-tools: original reference compose file from upstream

Infrastructure created on Proxmox:
- LXC 106 (media, Debian 12, privileged, nesting=1, 10.10.1.50/vmbr1)
- ZFS dataset hdd/media mounted at /media in LXC
- NVIDIA device passthrough entries in /etc/pve/lxc/106.conf

Note: NVIDIA driver 580.159.03 (.run) installed on Proxmox host — not
managed by apt (Debian only has 550.x which doesn't support kernel 7.x
or GTX 1060 Pascal as of this driver version).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 13:28:37 +02:00
Adyrem 30b2d42fcc Enforce firewall=0 on vmbr2 VMs to prevent NAT breakage
Ansible Lint / lint (push) Successful in 5s
When a VM has firewall=1, Proxmox inserts a fwbr bridge and iptables
POSTROUTING fires at the bridge step (OUT=fwbrNNNi0) rather than at
vmbr0. The MASQUERADE rule (-o vmbr0) never matches, so the VM loses
internet access.

Adds an idempotent task to the proxmox_host role that strips
firewall=1 from VM 105's net0 config whenever the playbook runs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 11:39:08 +02:00
Adyrem 80a3250cf6 Add /mtg route to Traefik and Pi-hole DNS
Routes adyrem.duckdns.org/mtg → http://10.10.2.10:3000 (claude-code-vm)
with StripPrefix so the app sees requests at /.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 10:24:33 +02:00
Adyrem 1d878a8d45 Scope port 80/443 DNAT to Proxmox public IP only
Without -d 192.168.1.10, the DNAT rule intercepted all TCP port 80/443
traffic arriving on vmbr0 — including LAN or routed traffic destined for
internal VMs like Pi-hole (10.10.1.2), redirecting it to Traefik instead.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 13:46:48 +02:00
Adyrem b9cb93b691 Remove scheduled_tasks.lock from tracking and gitignore it
Ansible Lint / lint (push) Successful in 4s
Runtime lock file created by the Claude Code harness — should never be committed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 04:55:11 +02:00
Adyrem f2321e1f45 Persist static IPs via Ansible to survive VM reboots
common role: add nmcli task that ensures the static IP, gateway, and DNS
are configured in NetworkManager — idempotent, only applies when
network_gateway is defined. Fixes Gitea going offline after reboot
because the NM connection had reverted to DHCP.

group_vars/infra: add network vars (10.10.1.0/24, gw 10.10.1.1)
group_vars/claude_code_vms: add network vars (10.10.2.0/24, gw 10.10.2.1)
  also fix ProxyJump to use adyrem@:2222 (root login was disabled)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 04:54:01 +02:00
Adyrem 1cf6c81ac5 Add sanoid Ansible role for ZFS snapshots and replication
Replaces manually deployed config files with a fully idempotent role:
installs sanoid, templates sanoid.conf and syncoid service/timer from
variables, enables both systemd timers. Removes static proxmox/sanoid.*
files. README rebuild section updated accordingly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 04:22:05 +02:00
Adyrem 18e05c2f88 Add README with rebuild procedure, VPN setup, and operations guide
Covers: infrastructure overview, SSH aliases, playbook usage, full
bare-metal rebuild sequence, WireGuard client setup (Linux/Windows/macOS),
ZFS snapshot restore, dev VM provisioning, monitoring onboarding,
and secrets management.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 04:16:17 +02:00
37 changed files with 1585 additions and 82 deletions
-1
View File
@@ -1 +0,0 @@
{"sessionId":"e2025a38-3d43-46f4-8c97-bbac5bc5681b","pid":40455,"procStart":"489090","acquiredAt":1778850952882}
+2
View File
@@ -1,8 +1,10 @@
keys/
wireguard/
certs/
*.vault
*.secret
ansible/vault_pass
user_credentials.json
archinstall-configs/creds.json
vms/
.claude/scheduled_tasks.lock
+267
View File
@@ -0,0 +1,267 @@
# Homelab
Proxmox VE homelab running on an Intel i7-8700 / 32 GB machine. All infrastructure is managed via Ansible. Secrets are encrypted with `ansible-vault`.
---
## Infrastructure Overview
| Component | Type | IP | Purpose |
|---|---|---|---|
| Proxmox host | bare metal | 192.168.1.10 | Hypervisor, WireGuard VPN server |
| gitea | VM 100 | 10.10.1.125 | Self-hosted Git + CI runner |
| monitoring | VM 101 | 10.10.1.137 | Prometheus, Grafana, Loki, Alertmanager |
| windows | VM 102 | — | Visual Studio (SPICE via Proxmox UI) |
| pihole | LXC 103 | 10.10.1.2 | DNS + ad blocking |
| traefik | LXC 104 | 10.10.1.3 | Reverse proxy + Let's Encrypt |
| claude-code | VM 105 | 10.10.2.10 | Persistent Claude Code session VM |
**Networks:**
- `vmbr1` 10.10.1.0/24 — infra (Gitea, monitoring, Pi-hole, Traefik)
- `vmbr2` 10.10.2.0/24 — dev (Claude Code VM)
- `vmbr3` 10.10.3.0/24 — desktop (Windows VM, isolated)
**Public endpoints:**
- `https://adyrem.duckdns.org/git` — Gitea
- Grafana: `http://10.10.1.137:3000` (VPN/LAN only)
- Proxmox UI: `https://10.10.1.10:8006` (VPN/LAN only; use `https://10.10.10.1:8006` over WireGuard)
---
## Prerequisites
- Ansible installed locally (`pip install ansible ansible-lint`)
- Vault password stored at `~/.config/homelab/vault_pass`
- WireGuard connected (for remote access) or on the LAN
```bash
cd ansible
export ANSIBLE_VAULT_PASSWORD_FILE=~/.config/homelab/vault_pass
```
---
## Day-to-day Operations
### SSH aliases (defined in `~/.ssh/config`)
```bash
ssh proxmox # Proxmox host (port 2222, user adyrem)
ssh gitea-vm # Gitea VM (via ProxyJump)
ssh monitoring-vm # Monitoring VM (via ProxyJump)
ssh pihole-ct # Pi-hole LXC (via ProxyJump)
ssh traefik-ct # Traefik LXC (via ProxyJump)
ssh claude-code-vm # Claude Code VM (via ProxyJump)
```
### Running playbooks
```bash
cd ansible
ansible-playbook playbooks/host.yml # Proxmox host config
ansible-playbook playbooks/gitea.yml # Gitea VM
ansible-playbook playbooks/monitoring.yml # Monitoring stack
ansible-playbook playbooks/pihole.yml # Pi-hole
ansible-playbook playbooks/traefik.yml # Traefik
ansible-playbook playbooks/claude-code-vm.yml
ansible-playbook playbooks/site.yml # All Arch VMs (common + node_exporter + promtail)
```
### Adding a WireGuard client
See [`ansible/playbooks/wireguard-README.md`](ansible/playbooks/wireguard-README.md) for step-by-step instructions.
---
## VPN Client Setup
WireGuard VPN is hosted on the Proxmox host (`adyrem.duckdns.org:51820`).
### Linux
```bash
# Install WireGuard
sudo apt install wireguard # Debian/Ubuntu
sudo pacman -S wireguard-tools # Arch
# Create config at /etc/wireguard/wg0.conf (see wireguard-README.md for template)
sudo systemctl enable --now wg-quick@wg0
# Verify
ping 10.10.10.1 # Proxmox host
```
### Windows
1. Download and install the [WireGuard app](https://www.wireguard.com/install/)
2. Open WireGuard → **Add Tunnel****Add empty tunnel**
3. Copy the generated public key — register it as a peer (see wireguard-README.md)
4. Paste the full client config, click **Activate**
### macOS / Android / iOS
Import the config file into the WireGuard app. The config template is in [`ansible/playbooks/wireguard-README.md`](ansible/playbooks/wireguard-README.md).
**Split tunnel:** only homelab traffic routes through the VPN (10.10.10.0/24, 10.10.1.0/24, 10.10.2.0/24). Internet traffic goes direct.
---
## Full Rebuild from Bare Metal
### 1. Install Proxmox
Boot the Proxmox VE ISO. During install:
- Disk: SSD (ZFS, single disk)
- Hostname: `homelab`
- IP: 192.168.1.10/24, gateway 192.168.1.1
- Timezone: Europe/Zurich
### 2. Restore ZFS data from HDD backup
SSH into the freshly installed host as `root`:
```bash
# Import HDD pool
zpool import hdd
# Restore VM disks
zfs receive -F rpool/data < <(syncoid hdd/backups/rpool-data rpool/data)
# Restore Proxmox OS datasets (optional — only if SSD was lost)
zfs receive -F rpool/ROOT/pve-1 < <(syncoid hdd/backups/pve-root rpool/ROOT/pve-1)
```
Or use syncoid directly for incremental restore:
```bash
syncoid --recursive hdd/backups/rpool-data rpool/data
```
### 3. Configure Proxmox host via Ansible
On first run, the playbook connects as `root` (before hardening):
```bash
cd ansible
ansible-playbook playbooks/host.yml
```
This creates `adyrem`, hardens SSH (port 2222, no root login), sets up the `claude-code` SFTP user, WireGuard, and DuckDNS. Root SSH access ends after this run.
Subsequent runs use `adyrem` (already set in `group_vars/proxmox_hosts/vars.yml`).
### 4. Configure network and firewall
Edit `/etc/network/interfaces` on Proxmox to restore the DNAT rules (port 80/443 → Traefik, port 53 → Pi-hole). Template is tracked at `proxmox/network-interfaces`.
Apply host firewall rules:
```bash
ansible-playbook playbooks/host.yml
```
### 5. Start infrastructure VMs/CTs and run playbooks
```bash
# Start VMs (or they start automatically if autostart was set)
# Run infra playbooks
cd ansible
ansible-playbook playbooks/pihole.yml
ansible-playbook playbooks/traefik.yml
ansible-playbook playbooks/gitea.yml
ansible-playbook playbooks/monitoring.yml
ansible-playbook playbooks/claude-code-vm.yml
```
### 6. Set up sanoid/syncoid for ZFS snapshots
Handled automatically by `playbooks/host.yml` (the `sanoid` role). No manual steps needed.
### 7. Restore Grafana password
Grafana bootstraps with password `admin`. Log in at `http://10.10.1.137:3000` and change it when prompted.
### 8. Reconfigure Internet-Box
- Port forward UDP 51820 → 192.168.1.10 (WireGuard)
- Port forward TCP 80 → 192.168.1.10 (Let's Encrypt HTTP-01)
- Port forward TCP 443 → 192.168.1.10 (HTTPS)
---
## Restore a VM from ZFS Snapshot
List available snapshots:
```bash
zfs list -t snapshot -r rpool/data
```
Roll back a VM disk to a snapshot:
```bash
# Stop the VM first (e.g., VM 100)
qm stop 100
# Roll back to snapshot
zfs rollback rpool/data/vm-100-disk-0@autosnap_2026-05-15_00:00:00_daily
# Start the VM
qm start 100
```
Restore a VM from the HDD backup pool (e.g., after SSD failure):
```bash
zfs send hdd/backups/rpool-data/vm-100-disk-0@<snapshot> | zfs receive rpool/data/vm-100-disk-0
```
---
## Provisioning a New Dev VM
Dev VMs run on `vmbr2` (10.10.2.0/24) so Claude Code has no path to infra.
1. Create the VM in the Proxmox UI (or clone an existing one). Assign a static IP on `vmbr2`.
2. Add it to the inventory:
```ini
# ansible/inventory/hosts.yml
dev_vms:
hosts:
my-new-vm:
ansible_host: 10.10.2.X
```
3. Run the base playbook:
```bash
ansible-playbook playbooks/site.yml --limit my-new-vm
```
4. Add an SSH alias in `~/.ssh/config` and in `ansible/roles/claude_code/templates/ssh_config.j2`, then re-run `ansible-playbook playbooks/claude-code-vm.yml`.
---
## Adding a New VM to Monitoring
Node Exporter and Promtail are installed by `site.yml` on all Arch VMs automatically.
For the VM to appear in Prometheus, add it to the scrape config in `ansible/roles/monitoring/templates/prometheus.yml.j2` under the appropriate job, then re-run:
```bash
ansible-playbook playbooks/monitoring.yml
```
Grafana dashboards are provisioned automatically from the datasource. For custom dashboards, export the JSON from Grafana UI and save to `files/grafana-dashboards/`.
---
## Secrets Management
Secrets are encrypted with `ansible-vault`. The vault password lives at `~/.config/homelab/vault_pass` (never committed).
```bash
# Encrypt a new secret
ansible-vault encrypt_string 'mysecret' --name 'vault_my_var'
# Edit an existing vault file
ansible-vault edit ansible/inventory/group_vars/all/vault.yml
# Run a playbook with vault
ansible-playbook playbooks/gitea.yml # picks up vault_pass from env var set above
```
+37 -34
View File
@@ -1,35 +1,38 @@
$ANSIBLE_VAULT;1.1;AES256
30353336323330616638366131616265353935386336623962313139666630386233333435376132
6632383465666533323435613938636564636166353265300a636531383030323130356439663538
39373933303438346138306430393831663236626132353031623837643563353536383432393866
3963613139663531620a613631636261653764663539323363326538373438326666646666643432
66663430333263653439613937326134653830663631363236663238663933613363343039393734
62313035653337363836633333636231643635656134396639653431646236353737353133343631
30343237373232356532363732366236343565353739353065363562643932386164366163343235
33363837626434306339623733623464646633656431643732303330353232656439313639363362
33376364343965323464663634386530303462613833333136623635366537363265646163653038
38376563353865636437313838313236333662376430303930356432663261383834626563343139
66643730373239623737383138663935313031373062646363663865366233383663336330333134
30333032366131363630303735653265636337616531656133343935306136303830333439656230
36303565643939616138323932393637373935396264666162356538313165656438306232613665
64666334306134323730383665666664303930646630343636653335653735323561393061323031
65643831353464353235626535346337663263396432356232323434653562656365386663636131
39663136313664353331373164616331626135356234623961663430653661316465393439643033
64653562383533383839386237323439376139333962396336386633653566656563636533366336
35313366336266633636383763643463376134316366393235313964313239373836336665353339
66303531336333646333326265646331353363653036313261663462626462653964306465383665
66313331656538336534653166363535336232316363303335663835656566623132383131373436
36366235643935373061366565623761333335666163326464326636626462663661346163323438
64653234333236383039393963336235643163653834303237366363633330613639353332616535
61323265346161313561396435643630383435633466636639316665353366343266306232663439
32653662666631636662323833646562353861333365303430326130633832313162316337643063
34393038646164363837306461303634653464343232663139363237353939323137333238613537
34616139376632373931343437316337383332343162363939633634303831353336333433633935
39343439313865343036376634653863653137653131363866363761653065313738316663383239
38383232626262303463393164326366633138313932366530663136616233313831303337316537
38343661663264303337346161323135366164373039663934343261663237396563383239663262
39383765643765396331333938666335663862303962353562663361323764643031373431306664
61646561353732323765363034326362663239666634316639356232633934663130663431613236
64336335653664646430653061313836386361316564353334336364626332303839363335343363
65653931363331383834373364616538336135633936363533383461373931666666373863386438
3231333561313139393966383964613731616139666536613536
31323435376435353462306465366666306330303932626563666533616264343239336236653865
6362303830313335363234663639323132313064383234650a613661353637613934666538653036
65343031666139326139626634653861633161633565333539663339633435306664396564656564
3361396638313836340a616539323161333465336162363063643832363231653037346234363533
66313661343562643663623132333138663536643062323064353632666365653435623233643634
61363034363562643733323164633130666133623034373639383663613661323065383230396265
65366331636235633534636237383332643436336665663366653164313266353236363362383864
32646131613136393863383031646163356463396662346231366365363436393961333462303434
64313738393132636537653438393030623363373037343930636137373436646630303137393035
33666238363039623266666538623634323165363262636565393134393530343137383965303662
30336536646431633235623636316132613437306338646435383037633534306336393538666237
39656330376339323464313134326165316163393965633964343136633035653934386633646133
32386235373031383037613835373966356334383539383162393136616566376335366239323961
38616334343238373361306561656635653334633561366139386465333462336161333637643234
63393231353166376362323434396265303630663530373538373665326662386264383762623835
37366234313930376366386336303963376232393066373133616332613439343430303664656137
37646630373332636136653634346363323766376635343838336531613934626362393961656266
65363333346664633261666132633166656665316537343464653436393662656565393136613839
30633932333062653836616637366365333937366134613965623139323163316332333636646439
64363238346430346437666363373463376630363539613365313231373237366666353737383264
39633261623231323962383564346265386633646664386461646332646637613363613134333163
65396362313139633436623839333032346436626633336165343665346133353330623833333530
30623362373261633630356563346231616462666336316165376230623166306362623734376538
36373039333538376634376534376431363462383764366462643436323964313361643732393964
37633635346433653636333432653365636666633963363230646636393035613335336231303138
32623735353465653230333264393137396265373866363666303264656135393464343633653063
33396539393566363735663537626634326432643836393161373837643561653432393237386337
32353962363964383363393833666165363334303462653736346538663762353133666165303034
39313833353465316531643238353238316231303638373964363861623766326565316438313839
38393735643635633431643634633436626335353462623766363663323132636263383235616237
65326334346462316630376532656338306438303639353537373766333566376238646265663237
65623366373766376636303033616566313131386564316135323436653563326464643662383534
38393061346339346461323438656239336236646166343738663232373565393763313365363439
61633639623661323132616138346433376134616334356534346332356635316333373931353265
35346432653231353864363935383966333336303962646563336133613336353239646361376532
31303830386335306237376366316663646136643462636162383134306431633065393338646139
3063
@@ -1,2 +1,7 @@
ansible_user: adyrem
ansible_ssh_common_args: "-o ProxyJump=root@192.168.1.10 -o StrictHostKeyChecking=accept-new"
ansible_ssh_common_args: "-o ProxyJump=adyrem@192.168.1.10:2222 -o StrictHostKeyChecking=accept-new"
network_interface: ens18
network_prefix: 24
network_gateway: 10.10.2.1
network_dns: 10.10.1.2
@@ -1 +1,6 @@
ansible_user: adyrem
network_interface: ens18
network_prefix: 24
network_gateway: 10.10.1.1
network_dns: 10.10.1.2
@@ -15,3 +15,6 @@ wireguard_peers:
- name: fedora
public_key: "ivtchk9pxEwYwusMzmn7Uq89LFV3uB1I8iYto0EJuy4="
allowed_ips: 10.10.10.2/32
- name: phone
public_key: "72fMMJTC/Ew38E61as+oEjFKsgKk4DAK8FqDuQOAcEU="
allowed_ips: 10.10.10.3/32
+5
View File
@@ -27,6 +27,11 @@ all:
claude-code:
ansible_host: 10.10.2.10
media_servers:
hosts:
media:
ansible_host: 10.10.1.50
pihole_servers:
hosts:
pihole:
+1
View File
@@ -11,3 +11,4 @@
hosts: proxmox_hosts
roles:
- proxmox_host
- sanoid
+6
View File
@@ -0,0 +1,6 @@
---
- name: Deploy Jellyfin media stack
hosts: media_servers
become: true
roles:
- jellyfin
+1
View File
@@ -6,6 +6,7 @@
|--------|--------------|
| server | 10.10.10.1 |
| fedora | 10.10.10.2 |
| phone | 10.10.10.3 |
Pick the next free IP (10.10.10.3, 10.10.10.4, …) for each new machine.
+20
View File
@@ -16,6 +16,26 @@
key: "{{ admin_ssh_key }}"
state: present
- name: Configure static IP via NetworkManager
ansible.builtin.shell: |
CURRENT=$(nmcli -t -f IP4.ADDRESS dev show {{ network_interface }} 2>/dev/null | cut -d: -f2)
EXPECTED="{{ ansible_host }}/{{ network_prefix }}"
if [ "$CURRENT" != "$EXPECTED" ]; then
CONN=$(nmcli -t -f NAME,DEVICE con show | grep ":{{ network_interface }}$" | cut -d: -f1 | head -1)
nmcli con mod "$CONN" \
ipv4.method manual \
ipv4.addresses "$EXPECTED" \
ipv4.gateway {{ network_gateway }} \
ipv4.dns {{ network_dns }}
nmcli con up "$CONN"
echo changed
else
echo ok
fi
register: _net
changed_when: "'changed' in _net.stdout"
when: network_gateway is defined
- name: Install base packages
community.general.pacman:
name:
+25
View File
@@ -0,0 +1,25 @@
---
jellyfin_version: "10.10.7"
qbittorrent_version: "5.1.4"
radarr_version: "6.0.4"
sonarr_version: "4.0.16"
prowlarr_version: "2.3.0"
flaresolverr_version: "v3.3.21"
jellyseerr_version: "2.5.2"
jellyfin_timezone: "Europe/Zurich"
jellyfin_puid: "1000"
jellyfin_pgid: "1000"
nvidia_driver_version: "580.159.03"
qbittorrent_webui_password: "{{ vault_qbittorrent_password }}"
jellyfin_config_dirs:
- /containers/jellyfin/config
- /containers/qbittorrent/config
- /containers/radarr/config
- /containers/sonarr/config
- /containers/prowlarr/config
- /containers/flaresolverr/config
- /containers/jellyseerr/config
+6
View File
@@ -0,0 +1,6 @@
---
- name: Restart jellyfin stack
ansible.builtin.systemd:
name: jellyfin-stack
state: restarted
daemon_reload: true
@@ -0,0 +1,567 @@
---
# --- Media library directories ---
- name: Create media library directories
ansible.builtin.file:
path: "{{ item }}"
state: directory
owner: "{{ jellyfin_puid }}"
group: "{{ jellyfin_pgid }}"
mode: "0755"
loop:
- /media/movies
- /media/tv
- /media/transcodes
# --- qBittorrent: pre-seed credentials on fresh install ---
- name: Check if qBittorrent config exists
ansible.builtin.stat:
path: /containers/qbittorrent/config/qBittorrent/qBittorrent.conf
register: _qbt_conf
- name: Deploy qBittorrent credential seed script
ansible.builtin.template:
src: qbittorrent_seed.py.j2
dest: /tmp/qbt_seed.py
mode: "0700"
when: not _qbt_conf.stat.exists
- name: Pre-seed qBittorrent credentials
ansible.builtin.command:
cmd: python3 /tmp/qbt_seed.py
when: not _qbt_conf.stat.exists
# --- Wait for services to be ready ---
- name: Read Radarr config
ansible.builtin.slurp:
src: /containers/radarr/config/config.xml
register: _radarr_config
- name: Read Sonarr config
ansible.builtin.slurp:
src: /containers/sonarr/config/config.xml
register: _sonarr_config
- name: Read Prowlarr config
ansible.builtin.slurp:
src: /containers/prowlarr/config/config.xml
register: _prowlarr_config
- name: Set API key facts
ansible.builtin.set_fact:
_radarr_key: "{{ (_radarr_config.content | b64decode | regex_search('<ApiKey>(.*?)</ApiKey>', '\\1'))[0] }}"
_sonarr_key: "{{ (_sonarr_config.content | b64decode | regex_search('<ApiKey>(.*?)</ApiKey>', '\\1'))[0] }}"
_prowlarr_key: "{{ (_prowlarr_config.content | b64decode | regex_search('<ApiKey>(.*?)</ApiKey>', '\\1'))[0] }}"
- name: Wait for Radarr
ansible.builtin.uri:
url: "http://localhost:7878/api/v3/system/status"
headers:
X-Api-Key: "{{ _radarr_key }}"
register: _r
until: _r.status == 200
retries: 12
delay: 5
- name: Wait for Sonarr
ansible.builtin.uri:
url: "http://localhost:8989/api/v3/system/status"
headers:
X-Api-Key: "{{ _sonarr_key }}"
register: _r
until: _r.status == 200
retries: 12
delay: 5
- name: Wait for Prowlarr
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/system/status"
headers:
X-Api-Key: "{{ _prowlarr_key }}"
register: _r
until: _r.status == 200
retries: 12
delay: 5
# --- Prowlarr: fix TPB season search ---
# apibay.org fulltext indexes "s05e01" as a single token, not "s05". When Prowlarr
# appends the season number to the query (the.boys.s05), apibay returns 0 results.
# Removing season/ep from the tv-search capability makes Prowlarr search with just
# the show title; Sonarr's parser then filters the results by season/episode.
# The file is locked read-only so Prowlarr cannot revert it on definition refresh.
- name: Wait for Prowlarr to write TPB definition file
ansible.builtin.stat:
path: /containers/prowlarr/config/Definitions/thepiratebay.yml
register: _tpb_def
until: _tpb_def.stat.exists
retries: 12
delay: 5
- name: Fix TPB tv-search to not append season to query
ansible.builtin.lineinfile:
path: /containers/prowlarr/config/Definitions/thepiratebay.yml
regexp: '^\s+tv-search: \[q, season, ep\]'
line: ' tv-search: [q]'
register: _tpb_fix
- name: Lock TPB definition read-only to prevent Prowlarr reverting the fix
ansible.builtin.file:
path: /containers/prowlarr/config/Definitions/thepiratebay.yml
mode: "0444"
- name: Restart Prowlarr to apply TPB definition fix
ansible.builtin.command:
cmd: docker restart prowlarr
changed_when: true
when: _tpb_fix.changed
- name: Wait for Prowlarr after restart
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/system/status"
headers:
X-Api-Key: "{{ _prowlarr_key }}"
register: _r
until: _r.status == 200
retries: 12
delay: 5
when: _tpb_fix.changed
# --- Radarr: download client ---
- name: Get Radarr download clients
ansible.builtin.uri:
url: "http://localhost:7878/api/v3/downloadclient"
headers:
X-Api-Key: "{{ _radarr_key }}"
register: _radarr_dc
- name: Add qBittorrent to Radarr
ansible.builtin.uri:
url: "http://localhost:7878/api/v3/downloadclient"
method: POST
headers:
X-Api-Key: "{{ _radarr_key }}"
body_format: json
body:
name: qBittorrent
enable: true
protocol: torrent
priority: 1
implementation: QBittorrent
configContract: QBittorrentSettings
fields:
- name: host
value: qbittorrent
- name: port
value: 5080
- name: useSsl
value: false
- name: username
value: admin
- name: password
value: "{{ qbittorrent_webui_password }}"
- name: movieCategory
value: radarr
tags: []
status_code: 201
when: _radarr_dc.json | selectattr('name', 'equalto', 'qBittorrent') | list | length == 0
# --- Radarr: root folder ---
- name: Get Radarr root folders
ansible.builtin.uri:
url: "http://localhost:7878/api/v3/rootfolder"
headers:
X-Api-Key: "{{ _radarr_key }}"
register: _radarr_rf
- name: Add movies root folder to Radarr
ansible.builtin.uri:
url: "http://localhost:7878/api/v3/rootfolder"
method: POST
headers:
X-Api-Key: "{{ _radarr_key }}"
body_format: json
body:
path: /downloads/movies
status_code: 201
when: _radarr_rf.json | selectattr('path', 'equalto', '/downloads/movies') | list | length == 0
# --- Sonarr: download client ---
- name: Get Sonarr download clients
ansible.builtin.uri:
url: "http://localhost:8989/api/v3/downloadclient"
headers:
X-Api-Key: "{{ _sonarr_key }}"
register: _sonarr_dc
- name: Add qBittorrent to Sonarr
ansible.builtin.uri:
url: "http://localhost:8989/api/v3/downloadclient"
method: POST
headers:
X-Api-Key: "{{ _sonarr_key }}"
body_format: json
body:
name: qBittorrent
enable: true
protocol: torrent
priority: 1
implementation: QBittorrent
configContract: QBittorrentSettings
fields:
- name: host
value: qbittorrent
- name: port
value: 5080
- name: useSsl
value: false
- name: username
value: admin
- name: password
value: "{{ qbittorrent_webui_password }}"
- name: tvCategory
value: sonarr
tags: []
status_code: 201
when: _sonarr_dc.json | selectattr('name', 'equalto', 'qBittorrent') | list | length == 0
# --- Sonarr: root folder ---
- name: Get Sonarr root folders
ansible.builtin.uri:
url: "http://localhost:8989/api/v3/rootfolder"
headers:
X-Api-Key: "{{ _sonarr_key }}"
register: _sonarr_rf
- name: Add TV root folder to Sonarr
ansible.builtin.uri:
url: "http://localhost:8989/api/v3/rootfolder"
method: POST
headers:
X-Api-Key: "{{ _sonarr_key }}"
body_format: json
body:
path: /downloads/tv
status_code: 201
when: _sonarr_rf.json | selectattr('path', 'equalto', '/downloads/tv') | list | length == 0
# --- Prowlarr: apps ---
- name: Get Prowlarr applications
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/applications"
headers:
X-Api-Key: "{{ _prowlarr_key }}"
register: _prowlarr_apps
- name: Add Radarr to Prowlarr
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/applications"
method: POST
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: Radarr
syncLevel: fullSync
implementation: Radarr
configContract: RadarrSettings
fields:
- name: prowlarrUrl
value: "http://prowlarr:9696"
- name: baseUrl
value: "http://radarr:7878"
- name: apiKey
value: "{{ _radarr_key }}"
- name: syncCategories
value: [2000, 2010, 2020, 2030, 2040, 2045, 2050, 2060]
tags: []
status_code: 201
when: _prowlarr_apps.json | selectattr('name', 'equalto', 'Radarr') | list | length == 0
- name: Add Sonarr to Prowlarr
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/applications"
method: POST
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: Sonarr
syncLevel: fullSync
implementation: Sonarr
configContract: SonarrSettings
fields:
- name: prowlarrUrl
value: "http://prowlarr:9696"
- name: baseUrl
value: "http://sonarr:8989"
- name: apiKey
value: "{{ _sonarr_key }}"
- name: syncCategories
value: [5000, 5010, 5020, 5030, 5040, 5045, 5050, 5060, 5070, 5080]
tags: []
status_code: 201
when: _prowlarr_apps.json | selectattr('name', 'equalto', 'Sonarr') | list | length == 0
# --- Prowlarr: FlareSolverr proxy ---
- name: Get Prowlarr indexer proxies
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexerproxy"
headers:
X-Api-Key: "{{ _prowlarr_key }}"
register: _prowlarr_proxies
- name: Add FlareSolverr proxy to Prowlarr
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexerproxy"
method: POST
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: FlareSolverr
implementation: FlareSolverr
configContract: FlareSolverrSettings
tags: [1]
fields:
- name: host
value: "http://flaresolverr:8191"
- name: requestTimeout
value: 60
status_code: 201
when: _prowlarr_proxies.json | selectattr('name', 'equalto', 'FlareSolverr') | list | length == 0
# --- Prowlarr: indexers ---
- name: Get Prowlarr indexers
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexer"
headers:
X-Api-Key: "{{ _prowlarr_key }}"
register: _prowlarr_indexers
- name: Add YTS indexer
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexer"
method: POST
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: YTS
enable: true
appProfileId: 1
priority: 25
implementation: Cardigann
configContract: CardigannSettings
tags: []
fields:
- name: definitionFile
value: yts
- name: baseSettings.limitsUnit
value: 0
- name: torrentBaseSettings.preferMagnetUrl
value: false
- name: apiurl
value: movies-api.accel.li
status_code: 201
when: _prowlarr_indexers.json | selectattr('name', 'equalto', 'YTS') | list | length == 0
- name: Add The Pirate Bay indexer
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexer"
method: POST
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: The Pirate Bay
enable: true
appProfileId: 1
priority: 25
implementation: Cardigann
configContract: CardigannSettings
tags: []
fields:
- name: definitionFile
value: thepiratebay
- name: baseSettings.limitsUnit
value: 0
- name: torrentBaseSettings.preferMagnetUrl
value: false
- name: apiurl
value: apibay.org
status_code: 201
when: _prowlarr_indexers.json | selectattr('name', 'equalto', 'The Pirate Bay') | list | length == 0
- name: Add EZTV indexer
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexer"
method: POST
timeout: 90
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: EZTV
enable: true
appProfileId: 1
priority: 25
implementation: Cardigann
configContract: CardigannSettings
tags: [1]
fields:
- name: definitionFile
value: eztv
- name: baseSettings.limitsUnit
value: 0
- name: torrentBaseSettings.preferMagnetUrl
value: false
status_code: 201
when: _prowlarr_indexers.json | selectattr('name', 'equalto', 'EZTV') | list | length == 0
ignore_errors: true
- name: Add 1337x indexer
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/indexer"
method: POST
timeout: 90
headers:
X-Api-Key: "{{ _prowlarr_key }}"
body_format: json
body:
name: 1337x
enable: true
appProfileId: 1
priority: 25
implementation: Cardigann
configContract: CardigannSettings
tags: [1]
fields:
- name: definitionFile
value: 1337x
- name: baseSettings.limitsUnit
value: 0
- name: torrentBaseSettings.preferMagnetUrl
value: false
- name: downloadlink
value: 0
- name: downloadlink2
value: 1
- name: sort
value: 2
- name: type
value: 1
status_code: 201
when: _prowlarr_indexers.json | selectattr('name', 'equalto', '1337x') | list | length == 0
ignore_errors: true
- name: Sync Prowlarr indexers to apps
ansible.builtin.uri:
url: "http://localhost:9696/api/v1/applications/syncindexers"
method: GET
headers:
X-Api-Key: "{{ _prowlarr_key }}"
status_code: [200, 202]
ignore_errors: true
# --- Jellyseerr: connect Sonarr and Radarr ---
- name: Check if Jellyseerr is initialized
ansible.builtin.stat:
path: /containers/jellyseerr/config/settings.json
register: _js_settings
- name: Read Jellyseerr settings
ansible.builtin.slurp:
src: /containers/jellyseerr/config/settings.json
register: _js_raw
when: _js_settings.stat.exists
- name: Set Jellyseerr API key fact
ansible.builtin.set_fact:
_js_key: "{{ (_js_raw.content | b64decode | from_json).main.apiKey }}"
when: _js_settings.stat.exists
- name: Get Jellyseerr Sonarr servers
ansible.builtin.uri:
url: "http://localhost:5055/api/v1/settings/sonarr"
headers:
X-Api-Key: "{{ _js_key }}"
register: _js_sonarr
when: _js_settings.stat.exists
- name: Configure Sonarr in Jellyseerr
ansible.builtin.uri:
url: "http://localhost:5055/api/v1/settings/sonarr/{{ '0' if (_js_sonarr.json | length == 0) else (_js_sonarr.json[0].id | string) }}"
method: "{{ 'POST' if (_js_sonarr.json | length == 0) else 'PUT' }}"
headers:
X-Api-Key: "{{ _js_key }}"
body_format: json
body:
name: sonarr
hostname: sonarr
port: 8989
apiKey: "{{ _sonarr_key }}"
useSsl: false
baseUrl: ""
activeProfileId: 4
activeProfileName: HD-1080p
activeDirectory: /downloads/tv
tags: []
animeTags: []
is4k: false
isDefault: true
enableSeasonFolders: true
syncEnabled: false
preventSearch: false
tagRequests: false
status_code: [200, 201]
when: >
_js_settings.stat.exists and
(_js_sonarr.json | length == 0 or not _js_sonarr.json[0].isDefault)
- name: Get Jellyseerr Radarr servers
ansible.builtin.uri:
url: "http://localhost:5055/api/v1/settings/radarr"
headers:
X-Api-Key: "{{ _js_key }}"
register: _js_radarr
when: _js_settings.stat.exists
- name: Configure Radarr in Jellyseerr
ansible.builtin.uri:
url: "http://localhost:5055/api/v1/settings/radarr/{{ '0' if (_js_radarr.json | length == 0) else (_js_radarr.json[0].id | string) }}"
method: "{{ 'POST' if (_js_radarr.json | length == 0) else 'PUT' }}"
headers:
X-Api-Key: "{{ _js_key }}"
body_format: json
body:
name: radarr
hostname: radarr
port: 7878
apiKey: "{{ _radarr_key }}"
useSsl: false
baseUrl: ""
activeProfileId: 4
activeProfileName: HD-1080p
activeDirectory: /downloads/movies
is4k: false
minimumAvailability: released
tags: []
isDefault: true
syncEnabled: false
preventSearch: false
tagRequests: false
status_code: [200, 201]
when: >
_js_settings.stat.exists and
(_js_radarr.json | length == 0 or not _js_radarr.json[0].isDefault)
+157
View File
@@ -0,0 +1,157 @@
---
# --- System setup ---
- name: Set timezone
community.general.timezone:
name: "{{ jellyfin_timezone }}"
- name: Grant adyrem passwordless sudo
ansible.builtin.copy:
dest: /etc/sudoers.d/adyrem
content: "adyrem ALL=(ALL:ALL) NOPASSWD: ALL\n"
owner: root
group: root
mode: "0440"
validate: visudo -cf %s
- name: Install base packages
ansible.builtin.apt:
name:
- curl
- ca-certificates
- gnupg
- apt-transport-https
state: present
update_cache: true
# --- Docker ---
- name: Add Docker GPG key
ansible.builtin.get_url:
url: https://download.docker.com/linux/debian/gpg
dest: /usr/share/keyrings/docker.asc
mode: "0644"
- name: Add Docker apt repository
ansible.builtin.apt_repository:
repo: >-
deb [arch=amd64 signed-by=/usr/share/keyrings/docker.asc]
https://download.docker.com/linux/debian bookworm stable
filename: docker
state: present
- name: Install Docker and compose plugin
ansible.builtin.apt:
name:
- docker-ce
- docker-ce-cli
- containerd.io
- docker-compose-plugin
state: present
update_cache: true
- name: Enable and start Docker
ansible.builtin.systemd:
name: docker
enabled: true
state: started
# --- NVIDIA container toolkit ---
- name: Add NVIDIA container toolkit GPG key
ansible.builtin.get_url:
url: https://nvidia.github.io/libnvidia-container/gpgkey
dest: /usr/share/keyrings/nvidia-container-toolkit.asc
mode: "0644"
- name: Add NVIDIA container toolkit apt repository
ansible.builtin.get_url:
url: https://nvidia.github.io/libnvidia-container/stable/deb/amd64/Packages
dest: /tmp/nvidia-ct-packages
mode: "0644"
check_mode: false
changed_when: false
- name: Write nvidia-container-toolkit sources list
ansible.builtin.copy:
dest: /etc/apt/sources.list.d/nvidia-container-toolkit.list
content: |
deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit.asc] https://nvidia.github.io/libnvidia-container/stable/deb/amd64 /
mode: "0644"
- name: Install nvidia-container-toolkit
ansible.builtin.apt:
name: nvidia-container-toolkit
state: present
update_cache: true
- name: Configure Docker to use NVIDIA runtime
ansible.builtin.command:
cmd: nvidia-ctk runtime configure --runtime=docker
changed_when: false
- name: Restart Docker to apply NVIDIA runtime
ansible.builtin.systemd:
name: docker
state: restarted
# --- NVIDIA userspace libraries ---
# The LXC has /dev/nvidia* bind-mounted from the host.
# The host's NVIDIA driver version must match what we install here.
- name: Check if NVIDIA userspace libraries are installed
ansible.builtin.stat:
path: /usr/lib/x86_64-linux-gnu/libcuda.so.{{ nvidia_driver_version }}
register: _nvidia_libs
- name: Download NVIDIA installer on LXC
ansible.builtin.get_url:
url: "https://download.nvidia.com/XFree86/Linux-x86_64/{{ nvidia_driver_version }}/NVIDIA-Linux-x86_64-{{ nvidia_driver_version }}.run"
dest: /tmp/nvidia.run
mode: "0755"
when: not _nvidia_libs.stat.exists
- name: Install NVIDIA userspace libraries (no kernel module)
ansible.builtin.command:
cmd: /tmp/nvidia.run --silent --no-kernel-module --no-drm
creates: /usr/lib/x86_64-linux-gnu/libcuda.so.{{ nvidia_driver_version }}
when: not _nvidia_libs.stat.exists
# --- Config directories and compose file ---
- name: Create container config directories
ansible.builtin.file:
path: "{{ item }}"
state: directory
mode: "0755"
loop: "{{ jellyfin_config_dirs }}"
- name: Create stack directory
ansible.builtin.file:
path: /opt/jellyfin
state: directory
mode: "0755"
- name: Deploy docker-compose.yml
ansible.builtin.template:
src: docker-compose.yml.j2
dest: /opt/jellyfin/docker-compose.yml
mode: "0644"
notify: Restart jellyfin stack
- name: Deploy systemd service
ansible.builtin.template:
src: jellyfin-stack.service.j2
dest: /etc/systemd/system/jellyfin-stack.service
mode: "0644"
notify: Restart jellyfin stack
- name: Enable and start jellyfin stack service
ansible.builtin.systemd:
name: jellyfin-stack
enabled: true
state: started
daemon_reload: true
- name: Configure services
ansible.builtin.include_tasks: configure_services.yml
@@ -0,0 +1,96 @@
name: jellyfin
services:
jellyfin:
image: jellyfin/jellyfin:{{ jellyfin_version }}
container_name: jellyfin
runtime: nvidia
environment:
- NVIDIA_VISIBLE_DEVICES=all
- NVIDIA_DRIVER_CAPABILITIES=compute,video,utility
- TZ={{ jellyfin_timezone }}
volumes:
- /containers/jellyfin/config:/config
- /media:/media
- /media/transcodes:/cache
ports:
- "8096:8096"
restart: unless-stopped
qbittorrent:
image: lscr.io/linuxserver/qbittorrent:{{ qbittorrent_version }}
container_name: qbittorrent
environment:
- PUID={{ jellyfin_puid }}
- PGID={{ jellyfin_pgid }}
- TZ={{ jellyfin_timezone }}
- WEBUI_PORT=5080
volumes:
- /containers/qbittorrent/config:/config
- /media:/downloads
ports:
- "5080:5080"
- "6881:6881"
- "6881:6881/udp"
restart: unless-stopped
radarr:
image: lscr.io/linuxserver/radarr:{{ radarr_version }}
container_name: radarr
environment:
- PUID={{ jellyfin_puid }}
- PGID={{ jellyfin_pgid }}
- TZ={{ jellyfin_timezone }}
volumes:
- /containers/radarr/config:/config
- /media:/downloads
ports:
- "7878:7878"
restart: unless-stopped
sonarr:
image: lscr.io/linuxserver/sonarr:{{ sonarr_version }}
container_name: sonarr
environment:
- PUID={{ jellyfin_puid }}
- PGID={{ jellyfin_pgid }}
- TZ={{ jellyfin_timezone }}
volumes:
- /containers/sonarr/config:/config
- /media:/downloads
ports:
- "8989:8989"
restart: unless-stopped
prowlarr:
image: lscr.io/linuxserver/prowlarr:{{ prowlarr_version }}
container_name: prowlarr
environment:
- PUID={{ jellyfin_puid }}
- PGID={{ jellyfin_pgid }}
- TZ={{ jellyfin_timezone }}
volumes:
- /containers/prowlarr/config:/config
ports:
- "9696:9696"
restart: unless-stopped
flaresolverr:
image: ghcr.io/flaresolverr/flaresolverr:{{ flaresolverr_version }}
container_name: flaresolverr
environment:
- LOG_LEVEL=info
- TZ={{ jellyfin_timezone }}
ports:
- "8191:8191"
restart: unless-stopped
jellyseerr:
image: ghcr.io/fallenbagel/jellyseerr:{{ jellyseerr_version }}
container_name: jellyseerr
environment:
- TZ={{ jellyfin_timezone }}
volumes:
- /containers/jellyseerr/config:/app/config
ports:
- "5055:5055"
restart: unless-stopped
@@ -0,0 +1,15 @@
[Unit]
Description=Jellyfin media stack
Requires=docker.service
After=docker.service
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/jellyfin
ExecStart=/usr/bin/docker compose up -d --remove-orphans
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=300
[Install]
WantedBy=multi-user.target
@@ -0,0 +1,17 @@
#!/usr/bin/env python3
import hashlib, os, base64
password = "{{ qbittorrent_webui_password }}"
salt = os.urandom(16)
dk = hashlib.pbkdf2_hmac("sha512", password.encode(), salt, 100000)
pw_hash = "@ByteArray(" + base64.b64encode(salt).decode() + ":" + base64.b64encode(dk).decode() + ")"
os.makedirs("/containers/qbittorrent/config/qBittorrent", exist_ok=True)
with open("/containers/qbittorrent/config/qBittorrent/qBittorrent.conf", "w") as f:
f.write("[Preferences]\n")
f.write('WebUI\\Password_PBKDF2="{}"\n'.format(pw_hash))
f.write("WebUI\\Port=5080\n")
f.write("WebUI\\Username=admin\n")
f.write("WebUI\\LocalHostAuth=false\n")
f.write("WebUI\\ServerDomains=*\n")
f.write("WebUI\\Address=*\n")
+10 -1
View File
@@ -8,5 +8,14 @@ pihole_dns_hosts:
- { ip: "10.10.1.2", host: "pihole.homelab" }
- { ip: "10.10.1.3", host: "traefik.homelab" }
- { ip: "10.10.1.125", host: "gitea.homelab" }
- { ip: "10.10.1.137", host: "grafana.homelab" }
- { ip: "10.10.1.3", host: "grafana.homelab" }
- { ip: "10.10.1.3", host: "proxmox.homelab" }
- { ip: "10.10.1.3", host: "adyrem.duckdns.org" }
- { ip: "10.10.1.3", host: "anki.homelab" }
- { ip: "10.10.1.3", host: "devbox.homelab" }
- { ip: "10.10.1.3", host: "jellyfin.homelab" }
- { ip: "10.10.1.3", host: "jellyseerr.homelab" }
- { ip: "10.10.1.3", host: "radarr.homelab" }
- { ip: "10.10.1.3", host: "sonarr.homelab" }
- { ip: "10.10.1.3", host: "prowlarr.homelab" }
- { ip: "10.10.1.3", host: "qbittorrent.homelab" }
@@ -7,15 +7,18 @@ hosts = [
{% endfor %}
]
hosts_str = "[" + ", ".join('"' + h + '"' for h in hosts) + "]"
hosts_str = "[\n" + "".join(' "' + h + '",\n' for h in hosts) + " ]"
with open("/etc/pihole/pihole.toml", "r") as f:
content = f.read()
# Only replace the first hosts= (DNS custom records section, not DHCP leases)
content = re.sub(
r"(?m)^( *hosts\s*=\s*)\[.*\]",
r"( *hosts\s*=\s*)\[.*?\]",
r"\g<1>" + hosts_str,
content,
count=1,
flags=re.DOTALL,
)
with open("/etc/pihole/pihole.toml", "w") as f:
@@ -10,6 +10,7 @@ DESIRED = [
{'proto': 'tcp', 'source': '10.10.10.0/24', 'dport': '2222'},
{'proto': 'tcp', 'source': '192.168.1.0/24', 'dport': '8006'},
{'proto': 'tcp', 'source': '10.10.10.0/24', 'dport': '8006'},
{'proto': 'tcp', 'source': '10.10.1.3', 'dport': '8006'},
{'proto': 'tcp', 'source': '192.168.1.0/24', 'dport': '3128'},
{'proto': 'udp', 'source': '10.10.0.0/16', 'dport': '53'},
{'proto': 'tcp', 'source': '10.10.0.0/16', 'dport': '53'},
+17
View File
@@ -205,3 +205,20 @@
enabled: true
state: started
daemon_reload: true
# --- VM network firewall flags ---
# vmbr2 VMs must have firewall=0 on their network interfaces.
# When firewall=1, Proxmox creates a fwbr bridge; iptables POSTROUTING fires
# at that bridge (OUT=fwbrNNNi0) before the packet reaches vmbr0, so the
# MASQUERADE rule (-o vmbr0) never matches and VMs lose internet access.
- name: Ensure claude-code VM (105) net0 has firewall disabled
ansible.builtin.shell: |
net0=$(qm config 105 | awk '/^net0:/ {print $2}')
if echo "$net0" | grep -q 'firewall=1'; then
qm set 105 --net0 "${net0//,firewall=1/,firewall=0}"
echo changed
fi
register: _vm105_fw
changed_when: "'changed' in _vm105_fw.stdout"
failed_when: false
+37
View File
@@ -0,0 +1,37 @@
---
sanoid_datasets:
- dataset: rpool/data
template: vms
recursive: true
- dataset: rpool/ROOT
template: system
recursive: true
sanoid_templates:
vms:
daily: 7
weekly: 4
monthly: 0
hourly: 0
frequently: 0
autosnap: true
autoprune: true
system:
daily: 3
weekly: 2
monthly: 0
hourly: 0
frequently: 0
autosnap: true
autoprune: true
syncoid_jobs:
- src: rpool/data
dst: hdd/backups/rpool-data
recursive: true
- src: rpool/ROOT/pve-1
dst: hdd/backups/pve-root
recursive: false
syncoid_schedule: "*-*-* 02:00:00"
syncoid_randomized_delay: 10min
+12
View File
@@ -0,0 +1,12 @@
---
- name: Restart sanoid timer
ansible.builtin.systemd:
name: sanoid.timer
state: restarted
daemon_reload: true
- name: Restart syncoid timer
ansible.builtin.systemd:
name: syncoid.timer
state: restarted
daemon_reload: true
+47
View File
@@ -0,0 +1,47 @@
---
- name: Install sanoid
ansible.builtin.apt:
name: sanoid
state: present
update_cache: true
- name: Deploy sanoid.conf
ansible.builtin.template:
src: sanoid.conf.j2
dest: /etc/sanoid/sanoid.conf
owner: root
group: root
mode: '0644'
notify: Restart sanoid timer
- name: Deploy syncoid systemd service
ansible.builtin.template:
src: syncoid.service.j2
dest: /etc/systemd/system/syncoid.service
owner: root
group: root
mode: '0644'
notify: Restart syncoid timer
- name: Deploy syncoid systemd timer
ansible.builtin.template:
src: syncoid.timer.j2
dest: /etc/systemd/system/syncoid.timer
owner: root
group: root
mode: '0644'
notify: Restart syncoid timer
- name: Enable and start sanoid timer
ansible.builtin.systemd:
name: sanoid.timer
enabled: true
state: started
daemon_reload: true
- name: Enable and start syncoid timer
ansible.builtin.systemd:
name: syncoid.timer
enabled: true
state: started
daemon_reload: true
@@ -0,0 +1,19 @@
{% for entry in sanoid_datasets %}
[{{ entry.dataset }}]
use_template = {{ entry.template }}
{% if entry.recursive %}
recursive = yes
{% endif %}
{% endfor %}
{% for name, t in sanoid_templates.items() %}
[template_{{ name }}]
daily = {{ t.daily }}
weekly = {{ t.weekly }}
monthly = {{ t.monthly }}
hourly = {{ t.hourly }}
frequently = {{ t.frequently }}
autosnap = {{ 'yes' if t.autosnap else 'no' }}
autoprune = {{ 'yes' if t.autoprune else 'no' }}
{% endfor %}
@@ -0,0 +1,9 @@
[Unit]
Description=Syncoid ZFS replication to HDD
After=zfs.target
[Service]
Type=oneshot
{% for job in syncoid_jobs %}
ExecStart=/usr/sbin/syncoid --no-privilege-elevation{% if job.recursive %} --recursive{% endif %} {{ job.src }} {{ job.dst }}
{% endfor %}
@@ -3,8 +3,8 @@ Description=Daily ZFS replication to HDD
After=sanoid.timer
[Timer]
OnCalendar=*-*-* 02:00:00
RandomizedDelaySec=10min
OnCalendar={{ syncoid_schedule }}
RandomizedDelaySec={{ syncoid_randomized_delay }}
Persistent=true
[Install]
+38
View File
@@ -13,9 +13,47 @@ traefik_services:
public_host: "adyrem.duckdns.org"
public_path: "/git"
strip_prefix: "/git"
- name: devbox
host: "devbox.homelab"
backend: "http://10.10.2.10:4001"
public_host: "adyrem.duckdns.org"
- name: anki
host: "anki.homelab"
backend: "http://10.10.2.10:4002"
public_host: "adyrem.duckdns.org"
public_path: "/Anki"
strip_prefix: "/Anki"
- name: mtg
host: "mtg.homelab"
backend: "http://10.10.2.10:3000"
public_host: "adyrem.duckdns.org"
public_path: "/mtg"
strip_prefix: "/mtg"
- name: grafana
host: "grafana.homelab"
backend: "http://10.10.1.137:3000"
- name: pihole
host: "pihole.homelab"
backend: "http://10.10.1.2:80"
- name: jellyfin
host: "jellyfin.homelab"
backend: "http://10.10.1.50:8096"
- name: jellyseerr
host: "jellyseerr.homelab"
backend: "http://10.10.1.50:5055"
- name: radarr
host: "radarr.homelab"
backend: "http://10.10.1.50:7878"
- name: sonarr
host: "sonarr.homelab"
backend: "http://10.10.1.50:8989"
- name: prowlarr
host: "prowlarr.homelab"
backend: "http://10.10.1.50:9696"
- name: qbittorrent
host: "qbittorrent.homelab"
backend: "http://10.10.1.50:5080"
- name: proxmox
host: "proxmox.homelab"
backend: "https://192.168.1.10:8006"
tls_skip_verify: true
+35
View File
@@ -60,6 +60,41 @@
when: traefik_version not in (traefik_installed_version.stdout | default(''))
notify: Restart traefik
- name: Create traefik certs directory
ansible.builtin.file:
path: /etc/traefik/certs
state: directory
owner: traefik
group: traefik
mode: "0750"
- name: Copy homelab TLS certificate
ansible.builtin.copy:
src: "{{ playbook_dir }}/../../certs/wildcard.homelab.pem"
dest: /etc/traefik/certs/homelab.pem
owner: traefik
group: traefik
mode: "0640"
notify: Restart traefik
- name: Copy homelab TLS key
ansible.builtin.copy:
src: "{{ playbook_dir }}/../../certs/wildcard.homelab-key.pem"
dest: /etc/traefik/certs/homelab-key.pem
owner: traefik
group: traefik
mode: "0640"
notify: Restart traefik
- name: Write Traefik TLS config
ansible.builtin.template:
src: tls.yml.j2
dest: /etc/traefik/conf.d/tls.yml
owner: traefik
group: traefik
mode: "0640"
notify: Restart traefik
- name: Write Traefik static config
ansible.builtin.template:
src: traefik.yml.j2
@@ -6,6 +6,8 @@ http:
service: {{ svc.name }}
entryPoints:
- web
- websecure
tls: {}
{% if svc.public_host is defined %}
{{ svc.name }}-public-redirect:
rule: "Host(`{{ svc.public_host }}`){% if svc.public_path is defined %} && PathPrefix(`{{ svc.public_path }}`){% endif %}"
@@ -48,4 +50,23 @@ http:
loadBalancer:
servers:
- url: "{{ svc.backend }}"
{% if svc.tls_skip_verify is defined and svc.tls_skip_verify %}
serversTransport: {{ svc.name }}-transport
{% endif %}
{% endfor %}
{% set ns = namespace(has_skip_verify=false) %}
{% for svc in traefik_services %}
{% if svc.tls_skip_verify is defined and svc.tls_skip_verify %}
{% set ns.has_skip_verify = true %}
{% endif %}
{% endfor %}
{% if ns.has_skip_verify %}
serversTransports:
{% for svc in traefik_services %}
{% if svc.tls_skip_verify is defined and svc.tls_skip_verify %}
{{ svc.name }}-transport:
insecureSkipVerify: true
{% endif %}
{% endfor %}
{% endif %}
@@ -0,0 +1,6 @@
tls:
stores:
default:
defaultCertificate:
certFile: /etc/traefik/certs/homelab.pem
keyFile: /etc/traefik/certs/homelab-key.pem
+82 -1
View File
@@ -298,7 +298,88 @@ In the event of full hardware loss, the rebuild order is:
---
## 10. Out of Scope (for now)
## 10. Media Stack (Jellyfin)
### Overview
A self-hosted media server and automation stack running in a dedicated LXC container on `infra-net`. All web UIs are internal-only, accessible via VPN or LAN. Port 6881 (BitTorrent peering) is the only internet-facing port.
### Services
| Container | Purpose | Port |
|---|---|---|
| Jellyfin | Media server / streaming | 8096 |
| Jellyseerr | Media request UI | 5055 |
| Radarr | Movie download management | 7878 |
| Sonarr | TV show download management | 8989 |
| Prowlarr | Indexer aggregator (feeds Radarr/Sonarr) | 9696 |
| FlareSolverr | Cloudflare bypass for Prowlarr | 8191 |
| qBittorrent | Torrent client | 5080 (UI), 6881 (peers) |
### LXC Container
- **Host:** Proxmox LXC, ID 106
- **Template:** Debian 12
- **Mode:** Privileged (required for NVIDIA device passthrough)
- **Features:** `nesting=1` (required for Docker)
- **Network:** `vmbr1` (infra-net), static IP `10.10.1.50`
- **Resources:** 4 CPU cores, 4GB RAM
- **GPU passthrough:** NVIDIA GTX 1060 via device node bind-mount (not PCIe passthrough)
- NVIDIA proprietary driver installed on Proxmox host
- Same driver version installed inside the LXC (versions must match exactly)
- Device nodes passed into LXC via `lxc.cgroup2.devices.allow`: `/dev/nvidia0`, `/dev/nvidiactl`, `/dev/nvidia-uvm`, `/dev/nvidia-uvm-tools`
- `nvidia-container-toolkit` installed inside LXC to enable Docker GPU access
- Jellyfin container configured to use NVENC (encoding) and NVDEC (decoding)
### Storage
- **Media library:** ZFS dataset `hdd/media`, bind-mounted into LXC at `/media`
- All containers share this path for downloads and library access
- **Config state:** `/containers/<service>/config` on LXC root dataset (SSD, rpool)
- Directories: `jellyfin`, `qbittorrent`, `radarr`, `sonarr`, `prowlarr`, `flaresolverr`, `jellyseerr`
### Deployment
- All services run via a single Docker Compose file managed by the `jellyfin` Ansible role
- Compose file derived from reference stack (`jellyfin-tools` in repo root) with:
- Jellyfin container added
- Traefik Docker labels removed (Traefik is a standalone LXC, not a Docker container)
- Docker `proxy` network removed; services reach each other by container name within Compose
- All image tags pinned (no `latest`)
- Timezone: `Europe/Zurich`
- Managed as a systemd service so it starts on LXC boot
### Routing (internal-only)
All services accessible at `.homelab` hostnames via Traefik (LXC 104, `10.10.1.3`). No public host — reachable via VPN or LAN only.
| Hostname | Backend |
|---|---|
| `jellyfin.homelab` | `http://10.10.1.50:8096` |
| `jellyseerr.homelab` | `http://10.10.1.50:5055` |
| `radarr.homelab` | `http://10.10.1.50:7878` |
| `sonarr.homelab` | `http://10.10.1.50:8989` |
| `prowlarr.homelab` | `http://10.10.1.50:9696` |
| `qbittorrent.homelab` | `http://10.10.1.50:5080` |
FlareSolverr has no web UI worth routing; Prowlarr reaches it by container name internally.
### DNS
Pi-hole A records: all 6 routed hostnames → `10.10.1.3` (Traefik).
### Port 6881 (BitTorrent Peering)
- **Proxmox DNAT** (in `proxmox/network-interfaces`): TCP+UDP 6881 on `192.168.1.10` → `10.10.1.50:6881`
- **Manual step:** Home router port-forward: 6881 TCP+UDP → `192.168.1.10`
- qBittorrent web UI (5080) remains internal-only
### Ansible
- New role: `jellyfin` — installs Docker, creates config dirs, deploys Compose file, enables systemd service
- New playbook: `jellyfin.yml` — targets the media LXC
- Media LXC added to inventory; included in `site.yml` for common/node_exporter/promtail roles
### NVIDIA Driver Notes
- Driver version on host and in LXC must be identical — this is a hard requirement for NVIDIA device passthrough
- The LXC does **not** need the full NVIDIA driver package (kernel modules already loaded on host); it only needs the userspace libraries (`nvidia-utils` / `libnvidia-compute`)
- `nvidia-smi` inside the LXC is the verification step after setup
- If a Proxmox host kernel update bumps the NVIDIA driver, the LXC libraries must be updated to match before Jellyfin transcoding will work again
---
## 11. Out of Scope (for now)
- External/cloud backups (architecture must not preclude adding later)
- Additional VM distros beyond those listed — template mechanism should make adding easy
+8 -4
View File
@@ -10,10 +10,14 @@ iface vmbr0 inet static
bridge-ports nic0
bridge-stp off
bridge-fd 0
post-up iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 80 -j DNAT --to-destination 10.10.1.3:80
post-up iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 443 -j DNAT --to-destination 10.10.1.3:443
post-down iptables -t nat -D PREROUTING -i vmbr0 -p tcp --dport 80 -j DNAT --to-destination 10.10.1.3:80
post-down iptables -t nat -D PREROUTING -i vmbr0 -p tcp --dport 443 -j DNAT --to-destination 10.10.1.3:443
post-up iptables -t nat -A PREROUTING -i vmbr0 -d 192.168.1.10 -p tcp --dport 6881 -j DNAT --to-destination 10.10.1.50:6881
post-up iptables -t nat -A PREROUTING -i vmbr0 -d 192.168.1.10 -p udp --dport 6881 -j DNAT --to-destination 10.10.1.50:6881
post-down iptables -t nat -D PREROUTING -i vmbr0 -d 192.168.1.10 -p tcp --dport 6881 -j DNAT --to-destination 10.10.1.50:6881
post-down iptables -t nat -D PREROUTING -i vmbr0 -d 192.168.1.10 -p udp --dport 6881 -j DNAT --to-destination 10.10.1.50:6881
post-up iptables -t nat -A PREROUTING -i vmbr0 -d 192.168.1.10 -p tcp --dport 80 -j DNAT --to-destination 10.10.1.3:80
post-up iptables -t nat -A PREROUTING -i vmbr0 -d 192.168.1.10 -p tcp --dport 443 -j DNAT --to-destination 10.10.1.3:443
post-down iptables -t nat -D PREROUTING -i vmbr0 -d 192.168.1.10 -p tcp --dport 80 -j DNAT --to-destination 10.10.1.3:80
post-down iptables -t nat -D PREROUTING -i vmbr0 -d 192.168.1.10 -p tcp --dport 443 -j DNAT --to-destination 10.10.1.3:443
post-up iptables -t nat -A PREROUTING -i vmbr0 -p udp --dport 53 -j DNAT --to-destination 10.10.1.2:53
post-up iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 53 -j DNAT --to-destination 10.10.1.2:53
post-up iptables -t nat -A POSTROUTING -p udp -d 10.10.1.2 --dport 53 -j MASQUERADE
-28
View File
@@ -1,28 +0,0 @@
# VM disks on SSD pool — snapshot daily/weekly
[rpool/data]
use_template = vms
recursive = yes
# Proxmox OS root — lighter schedule, mainly for recovery
[rpool/ROOT]
use_template = system
recursive = yes
#############################
[template_vms]
daily = 7
weekly = 4
monthly = 0
hourly = 0
frequently = 0
autosnap = yes
autoprune = yes
[template_system]
daily = 3
weekly = 2
monthly = 0
hourly = 0
frequently = 0
autosnap = yes
autoprune = yes
-8
View File
@@ -1,8 +0,0 @@
[Unit]
Description=Syncoid ZFS replication to HDD
After=zfs.target
[Service]
Type=oneshot
ExecStart=/usr/sbin/syncoid --recursive --no-privilege-elevation rpool/data hdd/backups/rpool-data
ExecStart=/usr/sbin/syncoid --no-privilege-elevation rpool/ROOT/pve-1 hdd/backups/pve-root