42 lines
2.0 KiB
Markdown
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]].
|