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

42 lines
2.0 KiB
Markdown

---
title: Recover a Docker service
type: runbook
status: active
created: 2026-07-22
updated: 2026-11-20
verified_on: 2026-11-20
tags: [runbook, docker, recovery]
sources: []
confidence: 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]].