Red Hat installation

To install Varnish Virtual Registry on a RHEL-based system, you can install the varnish-supervisor RPM package.

Step 1: Configure the repository

curl -s https://packagecloud.io/install/repositories/varnishplus/60-enterprise/script.rpm.sh | sudo bash

Step 2: Install the package

sudo yum -y install varnish-supervisor

To verify successful installation, run:

varnish-supervisor --version

Step 3: Start the service

On RHEL-based systems, services should not be started automatically during installation, so you have to enable it explicitly:

sudo systemctl enable varnish-supervisor && sudo systemctl enable varnish-supervisor

Check that systemd service started successfully:

systemctl status varnish-supervisor

Step 4: Customize configuration (Optional)

The package installs a default configuration file in /etc/varnish-supervisor/default.yaml. You can either edit this file directly (it won’t be replaced when upgrading the package), or change the ``–config` argument to a different path:

sudo systemctl edit --full varnish-supervisor

To have the changes take effect, restart the service:

sudo systemctl restart varnish-supervisor

For more information about Varnish Virtual Registry configuration, take a look at the configuration reference.

Step 5: Check that Varnish Virtual Registry is accepting traffic

Varnish Virtual Registry has a health-check endpoint at /healthz, and will respond with a 200 OK to all requests on that path regardless of Host.

curl http://localhost/healthz -I

HTTP/1.1 200 OK
Date: Wed, 29 Oct 2025 16:17:17 GMT
Content-Length: 0
Accept-Ranges: bytes
Connection: keep-alive

The default configuration has the Virtual Registry listening for HTTP traffic on port 80. If you have changed this to a different port, make sure to curl the right port and protocol.


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