The self-hosting guide predated the 0.9.0 secure-by-default release and
its quickstarts produced an unreachable server. Verified against a fresh
0.9.2 deployment.
self-hosting.md:
- Require CRAWL4AI_API_TOKEN in every quickstart (docker run, compose,
manual build); explain the loopback-only bind and the resulting
"connection reset" on published ports, plus startup-delay troubleshooting
- Compose: .llm.env is required; the token must be set inside it (host
`export` is not forwarded to the container)
- Replace the removed inline-Python hooks API (~600 lines) with the
declarative hooks reference: CRAWL4AI_HOOKS_ENABLED flag, action table,
/hooks/info, and 0.8.x migration notes
- Rewrite /screenshot and /pdf for the artifact flow; note output_path is
removed and currently silently ignored
- Fix dashboard URL (/dashboard, not /monitor); document the token bar in
the playground and dashboard UIs
- Fix stale versions (0.8.0 -> 0.9.2); drop the SDK function-hooks example
MIGRATION.md:
- Token setup instructions for compose (.llm.env) and docker run (explicit
-e form); clarify the loopback failure symptom
- Document CRAWL4AI_HOOKS_ENABLED and the silent failure modes of legacy
hooks.code and output_path
.llm.env.example:
- Add CRAWL4AI_API_TOKEN with guidance; add CRAWL4AI_HOOKS_ENABLED
Soham Kukreti
a659914ab3