Aller au contenu principal

Restart safely

Use this page when a controlled restart is justified and you need to preserve the verify path instead of turning the restart into a blind reset.

When to use this page​

  • A bounded runbook has narrowed the issue to a restartable service or stack boundary.
  • Health and readiness evidence exist already.
  • You need to restart the narrowest owned surface first.

Prerequisites​

  • You have already run Check stack health or an equivalent owner-specific diagnosis.
  • You can capture pre-restart health and readiness evidence.

Architecture / Flow​

Step-by-step procedure​

1. Confirm the restart boundary​

Before restarting, decide whether the problem is:

  • one service
  • one workflow lane
  • the whole host stack

2. Capture pre-restart evidence​

Use:

GET /health
GET /api/v1/platform/services

3. Run runtime guardrails before host mutation​

Use:

bash ./scripts/verify-runtime-guardrails.sh

This helps confirm the runtime posture before mutation.

4. Restart only when the owner path supports it​

If the bounded owner path confirms a stack restart is necessary:

bash ./scripts/redeploy-host-stack.sh

5. Re-verify after the restart​

Repeat the same health and readiness checks and confirm one downstream workflow or task that previously failed.

Verification​

This runbook is being used correctly when:

  1. pre-restart evidence exists
  2. the narrowest owned surface was restarted first
  3. post-restart verification included both endpoints and real behavior

Common failure modes​

Restarting the full stack before narrowing the issue​

Problem:

  • evidence is lost and blast radius grows.

Better path:

  • restart the smallest owned boundary first

Treating a successful restart command as recovery​

Problem:

  • the process restarts, but the original symptom remains.

Better path:

  • validate both readiness and one affected downstream path

Source Truth​

  • contracts/docs/public_manufacturer_docs_post_v1_runbooks_v1.json
  • JaddaHelpifyr/jhf-openclaw-env:docs/OPERATIONS.md
  • JaddaHelpifyr/jhf-openclaw-env:docs/TROUBLESHOOTING.md
  • JaddaHelpifyr/helpifyr-fabric:docs/operations/HOST_STACK_RUNBOOK.md

Next paths​