Skip to main content

Set up varnish and varnish logging

Project description

Varnish buildout recipe

This package provides buildout recipes for the configuration of varnish. This has a number of features and differences from plone.recipe.varnish, but it was inspired by that package.

This package also doesn’t provide all the features of plone.recipe.varnish, since it’s designed to be used slightly differently. Using this recipe you have one varnish daemon per deployed backend application server. If you have three different applications on a server, you will run three varnish daemons. This means they can be separately deployed, configured and maintained. This also means there is no need for host-header based routing.

Note that this package provides no support for installing varnish. Use the binary provided by your OS, or use zc.recipe.cmmi perhaps.

The key differences are:

  1. This packages uses isotoma.recipe.gocaptain to write the start/stop scripts, so it’s more likely to play well with your OS and behaves more normally
  2. Support for a separate logging system with each varnish instance, again using GoCaptain
  3. A different (and arguably more sane) basic varnish configuration
  4. Easy support for custom templates

Configuration example

A recipe for this package would look something like:

recipe = isotoma.recipe.varnish
name = mysite
bind =
backends =
varnishlog = /usr/bin/varnishncsa
logfile = /var/log/varnish/mysite.log

This would create two start scripts in your bin directory: varnish and varnishlog. The log instance will only log activity for this varnish instance.

Mandatory Parameters

The host:port to listen on
A list of backends (note only one backend is currently supported with the default template, because some director code is required. A custom template should work ok though, if you write one.)

Optional Parameters

This identifies the individual varnish instance - see the -n option to varnishd. (required if you are using varnishlog and recommended even if not)
The size of the cache.
The .connect_timeout option in the output VCL
The .first_byte_timeout option in the output VCL
The .between_bytes_timeout in the output VCL
The path to the varnishd daemon (default /usr/sbin/varnishd)
Any other parameters to pass at runtime (without the -p)
The user to run the daemon as (default nobody)
The group to run the daemon as (default nobody)
If you set this, you will get some very useful debugging headers in your HTTP output.
The path to the template to use, if you wish to provide a different one. It’s expected that this will be a Varnish 2.1 template. If you try to use Varnish 2.0, isotoma.recipe.varnish will attempt to downgrade the template.
Include lines matching the specified regex in the log output
Exclude lines matching the specified regex from the log output
Include lines with the specified tag in the log output
Exclude lines with the specified tag from the log output
The path to the logfile to write (required if varnishlog specified)
The path to the varnishlog binary - you can use either varnishlog or varnishncsa
Offer a management interface on the specified address and port. (format: address:port) Will generate a varnishadm wrapper in bin dir with the -T address:port already provided
By default HTML is explicitly excluded from being cached, to avoid various broken configurations we’ve seen. If you really want to cache HTML pages, set this to ‘on’


Copyright 2010 Isotoma Limited

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


0.1.7 (2012-01-23)

  • Add option to enable passthru headers

0.1.6 (2012-01-23)

  • Fix bug in previous change

0.1.5 (2012-01-23)

  • enabled switching of html caching with the ‘cachehtml’ option

0.1.4 (2012-01-09)

  • Provide a vcl_hash that doesn’t use the Host header

0.1.3 (2011-09-01)

  • Working varnishadm command

0.1.2 (2011-08-26)

  • Use ${:daemon} rather than assuming varnishd is on PATH.
  • If there is a ${buildout:run-directory}, put pid files there

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for isotoma.recipe.varnish, version 0.1.7
Filename, size File type Python version Upload date Hashes
Filename, size isotoma.recipe.varnish-0.1.7.tar.gz (9.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page