docs: document validate conflicts with exclusive resources - #569
Open
faiyazrahmann wants to merge 1 commit into
Open
docs: document validate conflicts with exclusive resources#569faiyazrahmann wants to merge 1 commit into
faiyazrahmann wants to merge 1 commit into
Conversation
steadytao
changed the title
steadytao
requested changes
Sep 10, 2026
caddy validate provisions modules for real. acme_server opens a database that only one process can hold at a time, so validating while Caddy runs times out even though the config is fine. Explain this in the caddy validate section and add a short note on the acme_server directive pointing back to it.
faiyazrahmann
force-pushed
the
docs-validate-running-instance
branch
from
September 10, 2026 04:48
1c19642 to
3a32167
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs follow up for caddyserver/caddy#8004.
caddy validateprovisions modules for real, so it fails when a runninginstance already holds an exclusive resource.
acme_serveris the commoncase: its database can only be open in one process at a time, so validate
times out even though the config is fine.
Adds an explanation in the
caddy validatesection, and a short note on theacme_serverdirective pointing back to it. Both say to validate beforestarting Caddy, or use
caddy reloadto check against a running instance.@steadytao you offered a review on this, so tagging you here.