Skip to content

Document 120s container stop timeout - #649

Merged
ruibaby merged 1 commit into
mainfrom
docs/container-stop-timeout
Nov 19, 2026
Merged

ruibaby merged 1 commit into
mainfrom
docs/container-stop-timeout

Conversation

@ruibaby

@ruibaby ruibaby commented Nov 19, 2026

Copy link
Copy Markdown
Member

Background

Halo's graceful shutdown can take longer than Docker's default 10-second stop timeout, especially on instances with many plugins. When the timeout expires, the container is killed before Halo finishes stopping plugins and saving index snapshots, so the next startup cannot reuse the snapshot and may leave plugin resources in an inconsistent state.

This change documents a 120-second stop timeout in all deployment examples so new installations have enough time to shut down gracefully.

Changes

  • Add stop_grace_period: 120s to the Halo service in all Docker Compose examples (PostgreSQL, MySQL, H2, external database, and Traefik).
  • Add stop_grace_period: 120s to the Redis integration Compose snippets.
  • Add --stop-timeout 120 to the docker run and podman run examples, including the multi-site examples in the FAQ.
  • Raise Podman Quadlet TimeoutStopSec from 70 to 120 in both examples.
  • Document the --stop-timeout option in the run parameter lists.

Validation

  • pnpm check:ci passes (lint and format check).

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
docs e16ee41 Commit Preview URL

Branch Preview URL
Nov 19 2026, 03:34 AM

@ruibaby
ruibaby merged commit 3b77e33 into main Nov 19, 2026
2 checks passed
@ruibaby
ruibaby deleted the docs/container-stop-timeout branch November 19, 2026 07:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant