Update a Docker-based Home Assistant deployment to the latest stable image and verify the service is healthy afterward. Use when a user asks to upgrade Home Assistant, check whether a Docker-based HA update is safe, or recover Home Assistant after an image refresh.
Use this skill for Docker-based Home Assistant deployments.
On first successful run, discover and persist the local runtime facts in:
references/local-runtime-facts.mdStore only the facts needed for repeatable upgrades, for example:
docker, podman, compose, etc.)On later runs:
references/local-runtime-facts.md first if it exists.Confirm deployment model first.
Pull the new image.
Recreate the container with the same runtime settings.
Verify Home Assistant health.
state is RUNNINGCheck for immediate regressions.
Inspect current container:
docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}"
docker inspect <home-assistant-container> --format "{{.Config.Image}} {{.HostConfig.NetworkMode}} {{.HostConfig.RestartPolicy.Name}}"
Upgrade:
docker pull ghcr.io/home-assistant/home-assistant:stable
docker stop <home-assistant-container>
docker rm <home-assistant-container>
docker run -d --name <home-assistant-container> <preserved-runtime-args> ghcr.io/home-assistant/home-assistant:stable
Verify API:
python3 - <<'PY'
import requests
from pathlib import Path
base = "<ha-base-url>"
token = Path("<token-file>").read_text().strip()
headers = {"Authorization": f"Bearer {token}"}
print(requests.get(base + "/api/config", headers=headers, timeout=10).json())
PY
Report: