{"result":{"depiction_url":null,"edges":{},"id":1990,"is_a":["text","documentation","developerguide"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1990"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_developerguide_deployment_varnish","page_url":{"en":"https:\/\/zotonic.com\/docs\/1990\/using-varnish-as-frontend-for-zotonic","x-default":"https:\/\/zotonic.com\/docs\/1990\/using-varnish-as-frontend-for-zotonic"},"preview_url":null,"resource":{"body":"
\n \n
\n\n

Using the Varnish HTTP frontend<\/a>,\nyou can speed up your Zotonic even more as this web server caches\nstatic files intelligently.<\/p>\n

Your Varnish config.vcl<\/span><\/code> needs to define a backend<\/cite> for Zotonic:<\/p>\n

<\/span>backend zotonic {\n  .host = "127.0.0.1";\n  .port = "8000";\n  .first_byte_timeout = 300s;\n  .connect_timeout = 300s;\n  .between_bytes_timeout = 300s;\n}\n<\/pre><\/div>\n<\/div>\n
Then, in vcl_recv<\/span><\/code>, specify the Zotonic backend as the default backend:<\/p>\n
<\/span>sub vcl_recv {\n  set req.http.X-Forwarded-Host = req.http.host;\n  set req.backend   = zotonic;\n\n  ...\n<\/pre><\/div>\n<\/div>\n
\n
Full varnish example configuration file<\/h2>\n
Please see the Varnish documentation<\/a> for more information.<\/p>\n
<\/span>#\n# Varnish configuration for a Zotonic site\n#\n\nbackend zotonic_com {\n  .host = "127.0.0.1";\n  .port = "8000";\n  .first_byte_timeout = 300s;\n  .connect_timeout = 300s;\n  .between_bytes_timeout = 300s;\n}\n\nbackend nginx {\n  .host = "127.0.0.1";\n  .port = "8080";\n  .first_byte_timeout = 300s;\n  .connect_timeout = 300s;\n  .between_bytes_timeout = 300s;\n}\n\n\nsub vcl_recv {\n  set req.http.X-Forwarded-Host = req.http.host;\n\n  ######################################################################\n  ########################### VIRTUAL HOSTS ############################\n\n  if (req.http.host ~ "^(www.|)(zotonic|example).(com|net)$") {\n    set req.backend   = zotonic_com;\n  }\n  # Nginx hosted sites\n  #\n  else {\n    set req.backend   = nginx;\n  }\n\n  ######################################################################\n\n  # Add a unique header containing the client address\n  unset req.http.X-Forwarded-For;\n  set   req.http.X-Forwarded-For = client.ip;\n\n  # We only deal with GET and HEAD by default\n  if (req.request != "GET" && req.request != "HEAD") {\n    return (pass);\n  }\n\n  # Cache the home page for a short period (ttl = 1 second, see vcl_fetch)\n  if (req.url ~ "^\/$") {\n    unset req.http.Cookie;\n    unset req.http.Authenticate;\n    set req.grace = 10s;\n    return (lookup);\n  }\n\n  # Cache served css and media files\n  if (req.url ~ "^\/(lib|image|media|favicon.ico)\/") {\n    unset req.http.Cookie;\n    unset req.http.Authenticate;\n    set req.grace = 30m;\n    return (lookup);\n  }\n\n  return (pass);\n}\n\n\nsub vcl_pipe {\n    # Note that only the first request to the backend will have\n    # X-Forwarded-For set.  If you use X-Forwarded-For and want to\n    # have it set for all requests, make sure to have:\n    set req.http.connection = "close";\n    return (pipe);\n}\n\n\nsub vcl_pass {\n  if (req.url ~ "^\/comet") {\n    #bereq.connect_timeout = 70;\n    #bereq.first_byte_timeout = 70;\n  }\n  return (pass);\n}\n\n\nsub vcl_fetch {\n  if (req.url ~ "^\/(lib|image|media|favicon.ico)\/") {\n    unset beresp.http.Set-Cookie;\n    set beresp.grace = 30m;\n    set beresp.ttl = 10m;\n    return (deliver);\n  }\n  return (pass);\n}\n\nsub vcl_error {\n  if (obj.status == 503 && req.restarts < 4) {\n    restart;\n  }\n}\n\n\n<\/pre><\/div>\n<\/div>\n<\/div>\n
\n
Auto-starting Varnish on Mac OSX<\/h2>\n
To automatically start Varnish on Max OSX, add the following plist<\/span><\/code> file to launchd.<\/p>\n
<\/span><?xml version="1.0" encoding="UTF-8"?><\/span>\n<!DOCTYPE plist PUBLIC "-\/\/Apple\/\/DTD PLIST 1.0\/\/EN" "http:\/\/www.apple.com\/DTDs\/PropertyList-1.0.dtd"><\/span>\n<plist<\/span> version=<\/span>"1.0"<\/span>><\/span>\n<dict><\/span>\n    <key><\/span>Disabled<\/key><\/span>\n    <false\/><\/span>\n    <key><\/span>KeepAlive<\/key><\/span>\n    <false\/><\/span>\n    <key><\/span>Debug<\/key><\/span>\n    <false\/><\/span>\n    <key><\/span>Label<\/key><\/span>\n    <string><\/span>varnishd<\/string><\/span>\n    <key><\/span>OnDemand<\/key><\/span>\n    <false\/><\/span>\n    <key><\/span>GroupName<\/key><\/span>\n    <string><\/span>wheel<\/string><\/span>\n    <key><\/span>UserName<\/key><\/span>\n    <string><\/span>root<\/string><\/span>\n    <key><\/span>ProgramArguments<\/key><\/span>\n    <array><\/span>\n        <string><\/span>\/usr\/local\/sbin\/varnishd<\/string><\/span>\n        <string><\/span>-F<\/string><\/span>\n        <string><\/span>-a<\/string><\/span>\n        <string><\/span>:80<\/string><\/span>\n        <string><\/span>-T<\/string><\/span>\n        <string><\/span>localhost:6082<\/string><\/span>\n        <string><\/span>-f<\/string><\/span>\n        <string><\/span>\/usr\/local\/etc\/varnish\/varnish.zotonic.vcl<\/string><\/span>\n        <string><\/span>-s<\/string><\/span>\n        <string><\/span>malloc<\/string><\/span>\n        <string><\/span>-u<\/string><\/span>\n        <string><\/span>nobody<\/string><\/span>\n    <\/array><\/span>\n    <key><\/span>RunAtLoad<\/key><\/span>\n    <false\/><\/span>\n<\/dict><\/span>\n<\/plist><\/span>\n<\/pre><\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n           <\/div>","category_id":{"id":317,"is_a":["meta","category"],"name":"developerguide","title":"Developer guide","uri":"https:\/\/zotonic.com\/id\/developerguide"},"content_group_id":{"id":339,"is_a":["meta","content_group"],"name":"default_content_group","title":{"_type":"trans","tr":{"en":"Default Content Group"}},"uri":"https:\/\/zotonic.com\/id\/default_content_group"},"created":"2020-05-30T05:47:48Z","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"github_url":"https:\/\/github.com\/zotonic\/zotonic\/tree\/master\/doc\/developer-guide\/deployment\/varnish.rst","is_authoritative":true,"is_dependent":false,"is_featured":false,"is_protected":false,"is_published":true,"is_unfindable":false,"language":["en"],"modified":"2022-02-15T10:01:38Z","modifier_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"name":"doc_developerguide_deployment_varnish","pivot_geocode":null,"pivot_location_lat":null,"pivot_location_lng":null,"privacy":0,"publication_end":"9999-06-01T00:00:00Z","publication_start":"2022-02-15T10:01:38Z","slug":"using-varnish-as-frontend-for-zotonic","title":"Using Varnish as frontend for Zotonic","title_slug":"using-varnish-as-frontend-for-zotonic","tz":"UTC","uri":null,"version":18,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/1990","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1990"}},"status":"ok"}