Skip to main content

License your installation

Issue a license in the customer portal and apply it inside TestVibe.

How licensing works​

  • A signed license belongs to one installation identity. Your subscription controls the number of deployments you can activate.

Find the installation ID​

  • Sign in as an instance administrator. Open Settings → Administration → License and copy the installation ID.

Issue the license​

  • Open the portal’s License tab, paste the installation ID, and enter a name for the deployment. Choose Issue license.
  • Reissuing for the same installation does not create a new deployment.

Apply the license​

  • Paste the license into Settings → Administration → License and choose Apply license. Confirm the status becomes valid.
  • An invalid, expired or wrong-installation license is rejected without replacing the installed license.

Host-managed licensing​

  • TV_LICENSE or TV_LICENSE_FILE takes precedence when configured. Update that deployment setting if the license is managed by the host.

Grace period and expiry​

  • A new installation normally has a 14-day grace period. After it expires without a valid license, new work is blocked and existing data stays readable.
  • Restarting does not reset the grace period. Administration and host recovery remain the paths to restore the installation.

Preserve identity on upgrades​

  • Keep the database and existing appliance data disk. They retain the installation identity and license.
  • A genuinely new installation needs a license for its new identity.

What to keep​

  • Keep your subscription account, installation ID, backup records and signed license in your organization’s records. Do not publish registry passwords or private keys.

Activation problems​

  • Confirm the license belongs to this installation and has not expired. Check whether a host-managed license overrides the pasted value.
  • Contact support with the installation ID and displayed error; do not send passwords or secret configuration.