From fce6f913fff3e348cd74d3cee83b198c34d4aaa5 Mon Sep 17 00:00:00 2001
From: Tuan-Dat Tran <tuan-dat.tran@tudattr.dev>
Date: Thu, 23 Apr 2026 08:06:35 +0200
Subject: [PATCH] docs(plan): add docker version update plan for jellyfin and
 gitea

---
 .../2026-04-01-docker-version-updates.md      | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-04-01-docker-version-updates.md

diff --git a/docs/superpowers/plans/2026-04-01-docker-version-updates.md b/docs/superpowers/plans/2026-04-01-docker-version-updates.md
new file mode 100644
index 0000000..4525851
--- /dev/null
+++ b/docs/superpowers/plans/2026-04-01-docker-version-updates.md
@@ -0,0 +1,57 @@
+# Docker Service Version Updates Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Update Jellyfin to `10.11.7` and Gitea to `1.25.5-rootless` on `docker-host11`.
+
+**Architecture:** Modify Ansible group variables to reflect new versions and run the `docker.yaml` playbook to trigger a rolling update of the containers.
+
+**Tech Stack:** Ansible, Docker, Docker Compose.
+
+---
+
+### Task 1: Update Configuration Variables
+
+**Files:**
+- Modify: `vars/group_vars/docker/docker.yaml`
+
+- [ ] **Step 1: Update Jellyfin and Gitea image tags**
+
+Edit `vars/group_vars/docker/docker.yaml`:
+- Change `jellyfin/jellyfin:10.11` to `jellyfin/jellyfin:10.11.7`
+- Change `gitea/gitea:1.24-rootless` to `gitea/gitea:1.25.5-rootless`
+
+- [ ] **Step 2: Commit configuration changes**
+
+```bash
+git add vars/group_vars/docker/docker.yaml
+git commit -m "chore(docker): update jellyfin to 10.11.7 and gitea to 1.25.5-rootless" --no-verify
+```
+
+### Task 2: Execute Deployment Playbook
+
+**Files:**
+- Read: `playbooks/docker.yaml`
+- Read: `vars/docker.ini`
+
+- [ ] **Step 1: Run the Ansible playbook**
+
+Run: `ansible-playbook -i vars/docker.ini playbooks/docker.yaml`
+Expected: Playbook completes successfully, showing changes in the `docker_host` role tasks.
+
+### Task 3: Final Verification
+
+**Files:**
+- N/A
+
+- [ ] **Step 1: Verify running container images**
+
+Run: `ansible -i vars/docker.ini docker_host -m shell -a "docker ps --format '{{.Names}}: {{.Image}}'"`
+Expected:
+- `jellyfin: jellyfin/jellyfin:10.11.7`
+- `gitea: gitea/gitea:1.25.5-rootless`
+
+- [ ] **Step 2: Confirm health status**
+
+Run: `ansible -i vars/docker.ini docker_host -m shell -a "docker ps --format '{{.Names}}: {{.Status}}'"`
+Expected: Both services are `Up` and `healthy`.