You are here

README.txt in Varnish 8

Same filename and directory in other branches
  1. 7 README.txt
CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Requirements
 * Recommended modules
 * Installation
 * Configuration
 * Maintainers

INTRODUCTION
------------

This module provides integration between your Drupal site and Varnish cache, an
advanced and very fast reverse-proxy system. Basically, Varnish handles serving
static files and anonymous page-views for your site much faster and at higher
volumes than Apache, in the neighborhood of 3000 requests per second.

This module provides admin-socket integration which allows Drupal to dynamically
 invalidate cache entries, and also lets you query the Varnish admin interface
 for status, etc.



REQUIREMENTS
------------

No special requirements.



RECOMMENDED MODULES
-------------------

* Purge(https://www.drupal.org/project/purge)
The purge module facilitates cleaning external caching systems, reverse proxies
and CDNs as content actually changes.



INSTALLATION
------------

 * Install as you would normally install a contributed Drupal module. See:
   https://www.drupal.org/node/1897420 for further information.




CONFIGURATION
-------------

* Go to Home >> Administration >> Configuration >> Development >> Varnish.

Here you can select your Varnish version and configure options for:

-Varnish Control Terminal: Set this to the server IP or hostname that varnish
runs on (e.g. 127.0.0.1:6082). This must be configured for Drupal to talk to
Varnish. Separate multiple servers with spaces.

-Varnish Control Key: if you have established a secret key for control terminal
access, please put it here.

-Varnish connection timeout: If Varnish is running on a different server, you
may need to increase this value.

-Varnish Cache Clearing: What kind of cache clearing Varnish should utilize.
The Drupal default will clear all page caches on node updates and cache flush
events. None will allow pages to persist for their full max-age; use this if you
 want to write your own cache-clearing logic.

-Varnish ban type: Select the type of varnish ban you wish to use. Ban lurker
support requires you to add beresp.http.x-url and beresp.http.x-host entries to
the response in vcl_fetch.


MAINTAINERS
-----------

* Colin Campbell (deadbeef) - (https://www.drupal.org/u/deadbeef)

* Mikke Schiren (MiSc) - (https://www.drupal.org/u/misc)

* JeremyFrench - (https://www.drupal.org/u/jeremyfrench)

* Josh Koenig (joshk) - (https://www.drupal.org/u/joshk)

* Fabian Sorqvist (fabsor) - (https://www.drupal.org/u/fabsor)

This project is supported by

* Wunder Group (http://drupal.org/wunder-group)

File

README.txt
View source
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Introduction
  4. * Requirements
  5. * Recommended modules
  6. * Installation
  7. * Configuration
  8. * Maintainers
  9. INTRODUCTION
  10. ------------
  11. This module provides integration between your Drupal site and Varnish cache, an
  12. advanced and very fast reverse-proxy system. Basically, Varnish handles serving
  13. static files and anonymous page-views for your site much faster and at higher
  14. volumes than Apache, in the neighborhood of 3000 requests per second.
  15. This module provides admin-socket integration which allows Drupal to dynamically
  16. invalidate cache entries, and also lets you query the Varnish admin interface
  17. for status, etc.
  18. REQUIREMENTS
  19. ------------
  20. No special requirements.
  21. RECOMMENDED MODULES
  22. -------------------
  23. * Purge(https://www.drupal.org/project/purge)
  24. The purge module facilitates cleaning external caching systems, reverse proxies
  25. and CDNs as content actually changes.
  26. INSTALLATION
  27. ------------
  28. * Install as you would normally install a contributed Drupal module. See:
  29. https://www.drupal.org/node/1897420 for further information.
  30. CONFIGURATION
  31. -------------
  32. * Go to Home >> Administration >> Configuration >> Development >> Varnish.
  33. Here you can select your Varnish version and configure options for:
  34. -Varnish Control Terminal: Set this to the server IP or hostname that varnish
  35. runs on (e.g. 127.0.0.1:6082). This must be configured for Drupal to talk to
  36. Varnish. Separate multiple servers with spaces.
  37. -Varnish Control Key: if you have established a secret key for control terminal
  38. access, please put it here.
  39. -Varnish connection timeout: If Varnish is running on a different server, you
  40. may need to increase this value.
  41. -Varnish Cache Clearing: What kind of cache clearing Varnish should utilize.
  42. The Drupal default will clear all page caches on node updates and cache flush
  43. events. None will allow pages to persist for their full max-age; use this if you
  44. want to write your own cache-clearing logic.
  45. -Varnish ban type: Select the type of varnish ban you wish to use. Ban lurker
  46. support requires you to add beresp.http.x-url and beresp.http.x-host entries to
  47. the response in vcl_fetch.
  48. MAINTAINERS
  49. -----------
  50. * Colin Campbell (deadbeef) - (https://www.drupal.org/u/deadbeef)
  51. * Mikke Schiren (MiSc) - (https://www.drupal.org/u/misc)
  52. * JeremyFrench - (https://www.drupal.org/u/jeremyfrench)
  53. * Josh Koenig (joshk) - (https://www.drupal.org/u/joshk)
  54. * Fabian Sorqvist (fabsor) - (https://www.drupal.org/u/fabsor)
  55. This project is supported by
  56. * Wunder Group (http://drupal.org/wunder-group)