bcicen/ctop · error

cannot unpause container: %v

Error message

cannot unpause container: %v

What it means

Wraps the error from the Docker Remote API's UnpauseContainer call in Docker.Unpause. It fires when the container cannot be resumed — it is not currently paused, has been removed, or the daemon cannot lift the cgroups freeze.

Source

Thrown at connector/manager/docker.go:140

func (dc *Docker) Unpause() error {
	if err := dc.client.UnpauseContainer(dc.id); err != nil {
		return fmt.Errorf("cannot unpause container: %v", err)
	}
	return nil
}

View on GitHub (pinned to 59f00dd6aa)

Solutions

  1. Only call Unpause on containers in the 'paused' state; inspect first
  2. Treat 'container is not paused' errors as idempotent success
  3. Retry after a short delay if the daemon was transiently unavailable
  4. Check daemon health and kernel cgroup support if failures persist
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at connector/manager/docker.go:140 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bcicen/ctop@59f00dd6aa (2026-09-02). Data as JSON: /api/errors/609b51d339544e68. Report an issue: GitHub.