Files
agent-estate-wiki/runbooks/recover-docker-service.md
T

2.0 KiB

title, type, status, created, updated, verified_on, tags, sources, confidence
title type status created updated verified_on tags sources confidence
Recover a Docker service runbook active 2026-07-22 2026-11-20 2026-11-20
runbook
docker
recovery
high

Recover Docker service

Procedure

  1. Identify the container.
  2. Inspect status and last 100 log lines.
  3. If unhealthy, restart then re-check.
  4. If still failing, inspect image and mounts.

Verification

Container shows healthy after recovery probe reboots.

Last successfully used

2026-07-22

Re-verified 2026-11-20 (stocktake, procedure only). docker ps as hermes on CT460 still returns permission denied (/var/run/docker.sock is root:docker 0660) — sudo or SSH to the owning host remains required. CT201 homepage degradation persists: :8085 answers 502 locally, homepage-manager up but no dashboard container on 8082. Steel remains fully removed (re-probed CT201/CT333: no containers, no images, no routes). Verified 2026-10-20 (procedure, not a live recovery). Before running any docker command from CT460, note that the hermes user has no access to /var/run/docker.sock — docker ps returns permission denied while trying to connect to the docker API. Use sudo, or SSH to the host that owns the container. The containers in this estate mostly live on CT201 (runtipi), CT209 (cloudreve) and m93p CT500 (LiteLLM) — not on CT460.

Two live situations this runbook would have been used for in the last week:

  • The CT201 homepage dashboard is degraded — main container removed, asset_proxy.py on 8085 proxying to a dead 8082, and the Tailscale / route returning 502. See systems/homepage-dashboard.
  • The Steel browser is not a recovery case — it was fully removed on 2026-10-29 (plugin, containers, images, network, project dir and Tailscale Serve routes deleted on CT201 and CT333), so there is no service to bring back. The browser backend is Camofox on CT460; see systems/browser-backend and decisions/rollback-steel-to-camofox.