Skip to main content

License Configuration

The [license] section specifies the path to your PRISM license file.

TOML Example​

[license]
path = "/etc/prism/license.lic"

Parameters​

ParameterTypeDefaultDescription
pathString or nullnullPath to the license file (.lic)

Detailed Explanation​

path​

Points to a PRISM license file on disk. The license file is a signed token that enables PRISM's full rendering capabilities.

Unlicensed mode​

When path is null or the license file is absent/invalid, PRISM runs in proxy-only mode:

  • All requests are forwarded directly to the origin
  • No headless browser rendering is performed
  • The admin API and health checks remain functional
  • PRISM acts as a transparent reverse proxy

This allows you to deploy PRISM in front of your application and activate rendering later by providing a valid license file, without any configuration changes.

License validation​

On startup, PRISM reads the license file and validates its Ed25519 signature. The license contains:

  • Licensee information
  • Expiration date
  • Feature flags

If the license is expired or the signature is invalid, PRISM falls back to proxy-only mode and logs a warning.

Example Use Cases​

Production with license​

[license]
path = "/etc/prism/license.lic"

Docker deployment with mounted license​

[license]
path = "/run/secrets/prism-license"

Evaluation / proxy-only mode​

[license]
# No path set -- runs in proxy-only mode