Use this tool to generate the exact commands needed for your environment using your Varnish Enterprise token.
Enter your Varnish Enterprise token and select your OS to generate tailored instructions.
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
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)
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
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
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
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
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
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
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
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