Jump to content

Vinyl Cache

From ArchWiki


Vinyl Cache is a web application accelerator also known as a caching HTTP reverse proxy. You install it in front of any HTTP server and configure it to cache the contents. Historically, the software was named Varnish Cache: However, trademark disputes resulted in the open-source project to be renamed to Vinyl Cache while the commercial product retains the Varnish Cache label.

Installation

Install the vinyl-cache package.

Customizing

By default, Vinyl Cache comes configured in /etc/vinyl-cache/default.vcl to use localhost:8080 as the only backend, default.vcl is called by the default vinyl-cache.service file.

You can enable the unit as-is, or override the defaults by editing it.

[Service]
ExecStart=
ExecStart=/usr/bin/vinyld -j unix,user=nobody -F -a :6081 -T localhost:6082 -f /etc/vinyl-cache/default.vcl -S /etc/vinyl-cache/secret -s malloc,1G

Also, if you change the configuration file /etc/vinyl-cache/default.vcl you will need to reload vinyl-cache.service:

Manual VCL load

If the previous VCL configuration reload failed, try loading the VCL file manually:

  1. Connect to the Vinyl Cache console:
    $ vinyladm -T localhost:6082
  2. Load the default VCL. Make sure it has at least one backend:
    vinyl> vcl.load default /etc/vinyl-cache/default.vcl
  3. Make it active:
    vinyl> vcl.use default
  4. Start the child proccess (optional):
    vinyl> start