ansible/docs/superpowers/plans/2026-04-01-docker-version-updates.md

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

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.