License

Configuration for the Premium License. The license unlocks Orca Premium functionality not available in the free version.

Example:

license:
  file: /etc/varnish-supervisor/license.lic

text

license:
  text: |
    <License>

Type: String

Provide a license as text in the configuration.

file

license:
  file: /etc/varnish-supervisor/license.lic

Type: String

Provide a path to the license.

Licensed features

A license carries a list of addons, and each addon unlocks one part of Orca. Running without a license is supported and unlocks none of them: a Virtual Registry caching public registries needs no license at all.

Addon Unlocks
sup-auth Caching from registries that require authentication. This is the preflight authorization machinery behind auth_ttl, auth_policy, auth_token_ttl and remote_auth.
sup-firewall The Artifact Firewall, enabled per registry with enable_firewall.
sup-clustering Clustering, enabled per registry with enable_cluster.
sup-persistence Persisted cache storage, which survives a restart.
sup-otel Tracing, together with the vmod-otel addon. Metrics and logs need neither.
sup-vclediting Custom VCL per registry, through extra_vcl.

The firewall and clustering need sup-auth alongside their own addon. Both handle requests that carry credentials, and neither is emitted into the generated VCL without it. The Supervisor warns at startup when one of them is licensed and sup-auth is not, since the feature would otherwise be listed as enabled and never engage.

A feature whose addon is missing is not an error. The setting is accepted and has no effect, so a configuration written for a licensed deployment still starts on an unlicensed one, serving what it can. The Supervisor logs each addon it found as it starts, which is the quickest way to see what a license actually carries.


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