Skip to content

params: Improve vcl_path documentation#41

Open
dridi wants to merge 1 commit intomainfrom
vcl_path_docs
Open

params: Improve vcl_path documentation#41
dridi wants to merge 1 commit intomainfrom
vcl_path_docs

Conversation

@dridi
Copy link
Copy Markdown
Member

@dridi dridi commented Apr 23, 2026

In the varnishd(1) manual I see this:

   vcl_path
       NB:  The  actual  default value for this parameter depends on the Varnish Cache
       build environment and options.

          • Default: ${sysconfdir}/varnish:${datadir}/varnish/vcl

       Directory (or colon separated list of  directories)  from  which  relative  VCL
       filenames  (vcl.load and include) are to be found.  Includes using +glob cannot
       be searched in vcl_path.

       The actual default value of vcl_path depends on the  build  configuration.   It
       offers  standardized  directories  for VCL installation for packages and opera‐
       tors.

       In the second component ${datadir} expands to a directory like  /usr/share  for
       packaged  VCL.   This is where a VMOD or VEXT may install companion VCL, avail‐
       able directly as a relative include.

       In the first component ${sysconfdir} expands to a directory like /etc for oper‐
       ations.  This is where system administrators may install VCL files.

       If a VCL file installed under ${datadir}/varnish/vcl must be locally patched, a
       file with the same name can be created under ${sysconfdir}/varnish to  override
       it without interfering with the package that installed the original one.

@dridi dridi added the documentation Improvements or additions to documentation label Apr 23, 2026
@daghf daghf self-requested a review April 28, 2026 13:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant