SynadiaDocs

Synadia Insights

Trial

A trial lets you run Insights against your own NATS system for a limited time.

Start a Trial

Request a trial at https://www.synadia.com/insights/trial. The trial email includes:

  • Download links for the trial archives for Linux (amd64, arm64), macOS (amd64, arm64), and Windows (amd64).
  • Credentials for the trial image, registry.synadia.io/insights-licensed:1.2.0 (linux/amd64, linux/arm64). The Helm chart uses the same image.
  • A trial license, valid for the evaluation period.

The trial includes every feature. Apart from where you download it and the license, the trial build installs and runs like any other. Follow Installation with the trial archives or image in place of the ones named there.

Configure the License

The trial build needs the license on every node that scrapes or indexes a NATS system. It doesn't need one for the simulator (--simulator) or for a node that only serves the web UI (insights web).

Save the license to a file and point Insights at it:

insights --license.file /etc/insights/license.jwt

license:
  file: /etc/insights/license.jwt

You can also pass the license text itself with --license.token, INSIGHTS_LICENSE_TOKEN, or license.token. A file is easier to rotate and stays out of shell history. If both are set, the file wins. See Configuration › license.

To run the trial image with the license mounted:

docker run -p 8080:8080 \
  -v insights-data:/var/lib/insights \
  -v /path/to/license.jwt:/etc/insights/license.jwt:ro \
  -v /path/to/sys.creds:/etc/insights/sys.creds:ro \
  registry.synadia.io/insights-licensed:1.2.0 \
  --license.file /etc/insights/license.jwt \
  --sys.server nats://your-nats:4222 \
  --sys.creds /etc/insights/sys.creds \
  --data-dir /var/lib/insights \
  --web.hostname 0.0.0.0

With Helm, set config.license.file or config.license.token and the chart deploys insights-licensed for you. You still need the registry pull secret from Installation. If the config comes from an existing Secret, the chart can't see the license, so set image.repository to insights-licensed yourself.

License Expiry

Insights logs the expiry date at startup:

level=INFO msg="license validated" expires_at=2026-12-31T23:59:59Z contract_type=trial

When the license expires, Insights keeps running but stops collecting new data. It logs scraper disabled: license expired at startup, or license expired, stopping scrapers if the license expires while it runs. The web UI and query API still serve the data collected before then. The web UI toolbar shows Trial mode while the license is valid and Upgrade to unlock after it expires.

To keep using Insights, contact Synadia. Configure the new license and restart to resume collecting.

Next
Installation