Varnish Cache Plus

Installation

The Varnish Plus offering has Varnish Cache Plus in its core, and most other components interact with it in one way or another. It is recommended that you install this first, but some other components (like the Varnish Administration Console) can be installed independently of Varnish Cache plus.

When you sign up for Varnish Cache Plus you will get a welcome letter with the necessary information to install Varnish Cache Plus. The letter will include a token that will be unique to your account, so it will be represented as TOKEN in this guide.

Installing Varnish Cache Plus is basically a two step process:

  1. Configure the repository for your Linux distribution
  2. Install the software using the built in package manager

Customers who cannot locate their user name and password should contact support@varnish-software.com.

Supported platforms

Varnish Cache Plus is distributed in prepackaged form for the most common Linux operating system distributions.

The list of supported distributions are:

  • RedHat Enterprise Linux 7
  • Ubuntu Linux 16.04 LTS (xenial)
  • Ubuntu Linux 18.04 LTS (bionic)
  • Debian 9.0 (stretch)

Legacy versions have different sets of supported platforms.

Varnish Cache Plus is supported on 64bit systems with Intel or AMD processors (x64).

Repository configuration Varnish Cache Plus

RedHat Enterprise Linux and derivatives

To use our Varnish Plus repositories, put the following in /etc/yum.repos.d/varnish-6.0-plus.repo:

[varnish-plus-60]
name=varnish-plus-60
baseurl=https://TOKEN:@packagecloud.io/varnishplus/60/el/$releasever/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://TOKEN:@packagecloud.io/varnishplus/60/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

You will also need to enable the epel-release repository to access some of the Varnish dependencies:

yum install epel-release

Ubuntu / Debian

Packages in our repositories are signed and distributed via HTTPS. You need to enable HTTPS support in the package manager and install our public key first:

apt-get install -y apt-transport-https
curl https://TOKEN:@packagecloud.io/varnishplus/60/gpgkey | apt-key add -

To use our Varnish Plus repositories, put the following in /etc/apt/sources.list.d/varnish-6.0-plus.list:

# be sure to replace "DIST" with "ubuntu" or "debian", and "RELEASE" with
# "xenial", "bionic" or "stretch" depending on your exact platform

# Varnish Cache Plus 6.0 and VMODs
deb https://TOKEN:@packagecloud.io/varnishplus/60/ubuntu/ trusty varnish-6.0-plus

Finish by updating the apt database:

apt update

Install through the package manager

After the repositories have been added, you can install the varnish-plus package:

# on RedHat and derivatives:
yum install varnish-plus
# on Ubuntu / Debian:
apt install varnish-plus

Installing Varnish modules

In 6.0 many Varnish modules (VMODs) are embedded in the varnish-plus package, and no extra installation is required.

Modules with third-party package dependencies (libcurl, libmemcached) are available in a separate package called varnish-plus-vmods-extra. This package is not installed by default.

The source code for some of these VMODs are available at https://github.com/varnish/varnish-modules/.