Skip to content

Varnish

Varnish Cache is a web application accelerator also known as a caching HTTP reverse proxy. You install it in front of any server that speaks HTTP and configure it to cache the contents.

You can easily add it to your Lando app by adding an entry to the services top-level config in your Landofile.

yaml
services:
  myservice:
    type: varnish
    backends:
      - appserver
    backend_port: 80

Supported versions

Patch versions

This service does not support patch versions but if you really need something like that, you could consider using either a custom compose service or a service overrides.

Custom Installation

This plugin is included with Lando by default. That means if you have Lando version 3.0.8 or higher then this plugin is already installed!

However if you would like to manually install the plugin, update it to the bleeding edge or install a particular version then use the below. Note that this installation method requires Lando 3.5.0+.

::: code-group-item LANDO 3.21+

bash
lando plugin-add @lando/varnish

::: ::: code-group-item HYPERDRIVE

bash
# @TODO
# @NOTE: This doesn't actaully work yet
hyperdrive install @lando/varnish

::: ::: code-group-item DOCKER

bash
# Ensure you have a global plugins directory
mkdir -p ~/.lando/plugins

# Install plugin
# NOTE: Modify the "npm install @lando/varnish" line to install a particular version eg
# npm install @lando/varnish@0.5.2
docker run --rm -it -v ${HOME}/.lando/plugins:/plugins -w /tmp node:14-alpine sh -c \
  "npm init -y \
  && npm install @lando/varnish --production --flat --no-default-rc --no-lockfile --link-duplicates \
  && npm install --production --cwd /tmp/node_modules/@lando/varnish \
  && mkdir -p /plugins/@lando \
  && mv --force /tmp/node_modules/@lando/varnish /plugins/@lando/varnish"

# Rebuild the plugin cache
lando --clear

:::

You should be able to verify the plugin is installed by running lando config --path plugins and checking for @lando/varnish. This command will also show you where the plugin is being loaded from.