varnish-agent [-c port] [-h] [-K agent-secret-file]
[-n name] [-p directory] [-q] [-r] [-l log-level]
[-S varnishd-secret-file] [-T host:port]
[-V] [-z vac_register_url] [-t seconds] [-w seconds]
The varnish-agent is a small daemon meant to communicate with Varnish
and other varnish-related services to allow remote control and monitoring
of Varnish.
For default values of options, including but not limited to where username
and password is read from (-K), where VCL is saved to (-p) and
where HTML is read from (-H), see varnish-agent -h.
-h
Print help.
-C
CA certificate for use by the cURL module. For use when the VAC
register URL is specified as https using a certificate that can not
be validated with the certificates in the system’s default
certificate directory.
-K agent-secret-file
Path to a file containing a single line representing the
username and password required to authenticate. It should
have a format of username:password.
-S varnishd-secret-file
Path to the shared secret file, used to authenticate with
varnish.
-T host:port (localhost:6082)
Hostname and port number for the management interface of
varnish.
-c port (6085)
Port number to listen for incoming connections.
-a host (0.0.0.0)
The host where the agent will run.
-i seconds (10)
Stats push interval to VAC, expressed in seconds.
Defaults to 10.
-l loglevel (warning)
Log level. Available options: debug, info, warning, error, quiet.
Defaults to warning.
-n name
Specify the varnish instance name. Must match the varnishd -n
option. Amongst other things, this name is used to construct a
path to the SHM-log file.
-p directory
Default path for VCL persistence. This is where VCL is stored.
If not set, the agent will evaluate the vc_dir parameter in
varnishadm, and use this.
-r (false)
Read-only mode. Only accept GET, HEAD and OPTIONS request
methods.
-u (varnish)
User to run as. Defaults to varnish.
-t (5)
Timeout in seconds for talking to varnishd.
-w (10)
Timeout in seconds for authentication with varnishd.
-k (false)
This option explicitly allows the agent to perform ‘insecure’ SSL
connections and transfers.
-V (false)
Show version and exit.
-z vac_register_url
Specify the callback VAC registration url that the agent will
contact when registering with the Varnish Administration Console.