Search
Varnish Enterprise

Token based deb/rpm installation

Use this tool to generate the exact commands needed for your environment using your Varnish Enterprise token.

Custom Installation Script Generator

Enter your Varnish Enterprise token and select your OS to generate tailored instructions.



Automated Installation

Note: Though easy and practical, this method isn’t recommended for setting up production environments.

You can install Varnish Enterprise by downloading and running this setup.sh. This will ask you for your repository token, then install the default set of Enterprise packages.

curl https://docs.varnish-software.com/scripts/setup.sh | bash

Other usages are possible for automation:

Specify a repository token for a fully automated install:

curl https://docs.varnish-software.com/scripts/setup.sh | TOKEN=YOUR_TOKEN bash

Use the INSTALL environment variable to restrict the packages you want to install and to specify their version:

curl https://docs.varnish-software.com/scripts/setup.sh | TOKEN=YOUR_TOKEN INSTALL="varnish-plus varnish-broadcaster-1.2.0-1.el7" bash

To see all the relevant environment variables

# To see all the relevant environment variables
curl -s https://docs.varnish-software.com/scripts/setup.sh | bash -s -- -h
usage: VAR1=VALUE1 VAR2=VALUE2 bash

This help script aims to provide a smooth way to setup varnish-plus repositories
as well as installing software contained in them.

It takes no arguments but instead reads environment variables to adapt its
behavior:
	TOKEN		The token to acess the repository (varnish-plus/6.0 by
				default)
	DIST		Force the Linux distribution to use (ubuntu, debian, centos).
				Setting this variable disables the OS autodection, so you will
				need to set REL too
				If set to "ask", display a menu instead of trying to guess it.
	REL			The release of the current distribution (eg. xenial for ubuntu,
				7 for centos). This is only needed if you forced DIST
	OVERWRITE	If not empty, asks before removing files (repos and gpg keys)
	INSTALL		Override the list of varnish-plus packages to install
	REPO		What repository to use (60, 60-akamai-connector,
				60-deviceatlas or 60-waf). It'll impact the default
				INSTALL value.
	VERBOSE		If not empty, run the package managers in quiet mode
	GPGKEY		Where the gpg key authenticating the repository can be
				stored (default: /tmp/varnish-plus-6.0.gpg)

Ubuntu 20.04 (Focal Fossa)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

apt-get update
apt-get install -y curl gnupg apt-transport-https

# Install the public key
curl -fsSL https://YOUR_TOKEN:@packagecloud.io/varnishplus/60/gpgkey | gpg --dearmor -o /etc/apt/trusted.gpg.d/varnish-enterprise-6.0.gpg

# Configure the credentials
cat << EOF > /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
machine packagecloud.io/varnishplus/60
login YOUR_TOKEN
EOF

# Make sure the credentials file is not world readable
chown root:root /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
chmod 600 /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf

# Configure the repository
cat << EOF > /etc/apt/sources.list.d/varnish-enterprise-6.0.list
deb https://packagecloud.io/varnishplus/60/ubuntu/ focal main
EOF

# Update repository data
apt-get update

# Install Varnish
apt-get install -y varnish-plus

Ubuntu 22.04 (Jammy Jellyfish)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

apt-get update
apt-get install -y curl gnupg apt-transport-https

# Install the public key
curl -fsSL https://YOUR_TOKEN:@packagecloud.io/varnishplus/60/gpgkey | gpg --dearmor -o /etc/apt/trusted.gpg.d/varnish-enterprise-6.0.gpg

# Configure the credentials
cat << EOF > /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
machine packagecloud.io/varnishplus/60
login YOUR_TOKEN
EOF

# Make sure the credentials file is not world readable
chown root:root /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
chmod 600 /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf

# Configure the repository
cat << EOF > /etc/apt/sources.list.d/varnish-enterprise-6.0.list
deb https://packagecloud.io/varnishplus/60/ubuntu/ jammy main
EOF

# Update repository data
apt-get update

# Install Varnish
apt-get install -y varnish-plus

Debian 13.0 (Trixie)

Packages in our private repositories are signed and distributed via HTTPS. You need to enable HTTPS support in the package manager and verify dependencies are present. All commands should be run as root:

apt-get update
apt-get install -y curl gnupg

# Install the public key
curl -fsSL https://YOUR_TOKEN:@packagecloud.io/varnishplus/60/gpgkey | gpg --dearmor -o /etc/apt/trusted.gpg.d/varnish-enterprise-6.0.gpg

# Configure the credentials
cat << EOF > /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
machine packagecloud.io/varnishplus/60
login YOUR_TOKEN
EOF

# Make sure the credentials file is not world readable
chown root:root /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
chmod 600 /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf

# Configure the repository
cat << EOF > /etc/apt/sources.list.d/varnish-enterprise-6.0.list
deb https://packagecloud.io/varnishplus/60/debian/ trixie main
EOF

# Add sha1 support
mkdir -p /etc/crypto-policies/back-ends/
printf "[hash_algorithms]\nsha1 = \"always\"\n" > /etc/crypto-policies/back-ends/apt-sequoia.config

# Update repository data
apt-get update

# Install Varnish
apt-get install -y varnish-plus

Debian 12.0 (Bookworm)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

apt-get update
apt-get install -y curl gnupg apt-transport-https

# Install the public key
curl -fsSL https://YOUR_TOKEN:@packagecloud.io/varnishplus/60/gpgkey | gpg --dearmor -o /etc/apt/trusted.gpg.d/varnish-enterprise-6.0.gpg

# Configure the credentials
cat << EOF > /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
machine packagecloud.io/varnishplus/60
login YOUR_TOKEN
EOF

# Make sure the credentials file is not world readable
chown root:root /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
chmod 600 /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf

# Configure the repository
cat << EOF > /etc/apt/sources.list.d/varnish-enterprise-6.0.list
deb https://packagecloud.io/varnishplus/60/debian/ bookworm main
EOF

# Update repository data
apt-get update

# Install Varnish
apt-get install -y varnish-plus

Debian 11.0 (Bullseye)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

apt-get update
apt-get install -y curl gnupg apt-transport-https

# Install the public key
curl -fsSL https://YOUR_TOKEN:@packagecloud.io/varnishplus/60/gpgkey | gpg --dearmor -o /etc/apt/trusted.gpg.d/varnish-enterprise-6.0.gpg

# Configure the credentials
cat << EOF > /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
machine packagecloud.io/varnishplus/60
login YOUR_TOKEN
EOF

# Make sure the credentials file is not world readable
chown root:root /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf
chmod 600 /etc/apt/auth.conf.d/varnish-enterprise-6.0.conf

# Configure the repository
cat << EOF > /etc/apt/sources.list.d/varnish-enterprise-6.0.list
deb https://packagecloud.io/varnishplus/60/debian/ bullseye main
EOF

# Update repository data
apt-get update

# Install Varnish
apt-get install -y varnish-plus

Red Hat Enterprise Linux 10 (RHEL)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

# Place the token in the yum vars directory
echo "YOUR_TOKEN" > /etc/yum/vars/varnish60token

# Enable the Extra Packages for Enterprise Linux (EPEL) repository
dnf install -y epel-release

# Configure the repository
cat << 'EOF' > /etc/yum.repos.d/varnish-enterprise-6.0.repo
[varnish-enterprise-6.0]
name=varnish-enterprise-6.0
baseurl=https://packagecloud.io/varnishplus/60/el/$releasever/$basearch
username=$varnish60token
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://$varnish60token:@packagecloud.io/varnishplus/60/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOF

# Update repository metadata
dnf -y makecache

# Install Varnish Enterprise
dnf -y install varnish-plus

Red Hat Enterprise Linux 9 (RHEL)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

# Place the token in the yum vars directory
echo "YOUR_TOKEN" > /etc/yum/vars/varnish60token

# Enable the Extra Packages for Enterprise Linux (EPEL) repository
dnf install -y epel-release

# Configure the repository
cat << 'EOF' > /etc/yum.repos.d/varnish-enterprise-6.0.repo
[varnish-enterprise-6.0]
name=varnish-enterprise-6.0
baseurl=https://packagecloud.io/varnishplus/60/el/$releasever/$basearch
username=$varnish60token
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://$varnish60token:@packagecloud.io/varnishplus/60/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOF

# Disable the default module stream for Varnish Cache
dnf -y module disable varnish

# Update repository metadata
dnf -y makecache

# Install Varnish Enterprise
dnf -y install varnish-plus

Red Hat Enterprise Linux 8 (RHEL)

Packages in our private repositories are signed and distributed via HTTPS. All commands should be run as root.

# Place the token in the yum vars directory
echo "YOUR_TOKEN" > /etc/yum/vars/varnish60token

# Enable the Extra Packages for Enterprise Linux (EPEL) repository
dnf install -y epel-release

# Configure the repository
cat << 'EOF' > /etc/yum.repos.d/varnish-enterprise-6.0.repo
[varnish-enterprise-6.0]
name=varnish-enterprise-6.0
baseurl=https://packagecloud.io/varnishplus/60/el/$releasever/$basearch
username=$varnish60token
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://$varnish60token:@packagecloud.io/varnishplus/60/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOF

# Disable the default module stream for Varnish Cache
dnf -y module disable varnish

# Update repository metadata
dnf -y makecache

# Install Varnish Enterprise
dnf -y install varnish-plus

®Varnish Software, Wallingatan 12, 111 60 Stockholm, Organization nr. 556805-6203