Overview

Licensing

This page explains licensing from the end user's perspective: what is needed, how to obtain the license, and how to apply it.

How to obtain a license

Review the prices and the databases covered by each tier (Launch price, Standard, Enterprise: all with every feature) and purchase on the public site:

After purchase you will receive an email with license-payload + license-signature to install as described in the "End User Procedure" below.

How It Works

  • The license is valid only if:
  • correct signature.
  • machineFingerprint of the current server is present in the machineFingerprints list of the signed payload.
  • the license has not expired (expiryUtc). A license that expires while the server is running stops being valid within 5 minutes (the validation is cached for that long), with no restart needed.
  • maintenance: the installed version is not newer than the end of maintenance (maintenanceExpiryUtc). If the build is later, the license is not valid (maintenance_expired), even if it has not expired.
  • database: if the signed payload has the databases field, the installation's dbms value must be one of those listed (Standard tier: mysql, postgresql). Otherwise the license is not valid (database_not_licensed) and the installation stays in Trial. Without the field the license is valid on every database: that is the case of the Launch price and Enterprise tiers and of every license issued before the field.
  • If the license is not valid, data reading (getFlatRecordData) is limited to a maximum of 20 records. That is the only Trial limit: every feature (spreadsheet, pivot, workflow, report and dashboard designers, RAG chatbot, offline-crud, host hooks such as customizeSelect) stays available, including with a license that lists only some features.

Where to Find the machineFingerprint

Backend endpoint:

  • GET /api/Meta/LicenseStatus → field machineFingerprint (also without a license; since 1.7.28 only to the verified superadmin, like licenseEmail and forceRefresh=true). Without a session LicenseStatus returns only licenseValid, tier, features, bundledHost and bundledHostAppId; with a session also expiry dates, reason and DBMS. With a session there is also licensedDatabases, the databases the license allows (empty = all), to be read next to dataDbms.
  • During the first run it is also exposed by GET /api/Meta/FirstRunStatus.
  • If the machine identity changes (cloned VM, recreated container) the fingerprint changes too: ask the vendor for a license for the new fingerprint (machineFingerprint from LicenseStatus).

Note: the local file installation.id is no longer used by licensing.

End User Procedure

1. Retrieve machineFingerprint from your host.

2. Send the value to the vendor/licensor.

3. Receive the license values:

  • license-payload
  • license-signature

4. Paste the values from the UI: Administration > AppSettings Editor, License section (fields License email, License payload, License signature), then save. The public key that verifies the signature is built into the framework and is not configurable (the editor no longer has a Public key (PEM) field, and license-public-key-pem in appsettings is ignored). Alternatively you can write them by hand in the AppSettings section of the running host's appsettings.{Environment}.json. The AppSettings editor requires a session with the superadmin role, checked server-side.

5. Verify the license status:

  • from the API: GET /api/Meta/LicenseStatus, expected licenseValid = true;
  • or from the page itself, which re-reads the license right after saving.

No backend restart is needed when you go through the editor. Saving license-payload / license-signature from the AppSettings Editor makes the backend refresh the validation service on its own, and the license applies from the next request. A restart is only needed in the other case, when the values are written by hand in the file: that one is read at startup.

Free apps

The free apps (FatturazioneElettronica, CrmApp, FlottaMezzi) ship in two distributions:

  • binary (-iis- zip): free, no license. The assembly is signed by the vendor and carries an embedded host binding license that authorizes the framework only for that application as distributed (LicenseStatus answers with bundledHost and bundledHostAppId);
  • sources (-src- zip): once recompiled, the vendor signature is gone and the procedure of this page applies, with the machine fingerprint. The free apps run on SQL Server: you need a tier that covers it (Launch price or Enterprise). Without a license the recompiled application runs in Trial mode.

Details on the page Free apps.

Multi-Machine License

A single license can authorize multiple machines by including multiple values in machineFingerprints.

Quick Troubleshooting

  • licenseReason = invalid_signature:
  • payload/signature are not consistent with each other (copied incompletely or modified) or were signed with a key other than the vendor's.
  • licenseReason = machine_fingerprint_not_authorized:
  • the current machine's fingerprint is not present in the received license.
  • licenseReason = machine_fingerprint_missing:
  • the runtime cannot calculate the local fingerprint.
  • licenseReason = license_expired:
  • the license has expired, request renewal.
  • licenseReason = maintenance_expired:
  • maintenance ended before the build date of the installed version: install a version released before the end of maintenance or renew maintenance.
  • licenseReason = database_not_licensed:
  • the license is valid only for the databases in licensedDatabases and the installation runs on dataDbms, which is not one of them: a Standard license covers MySQL and PostgreSQL, SQL Server and Oracle need Enterprise.

Screenshot

licensing / LicenseStatus API response (licenseValid=true, tier=developer)
licensing / LicenseStatus API response (licenseValid=true, tier=developer)