Documentation contents

License error messages

The server_id code means the key was issued for another server. The parent_missing code means the base license is missing.

Errors when installing a key

Look for the message from the app in the first column or the code from gadka admin license install in the second.

Message in the appCodeWhat to do
This does not look like a Gadka license key. Paste the whole block including the BEGIN/END lines.formatCopy the entire key again.
The key is not signed by the Gadka vendor or has been modified.signatureDownload the key again from the shop and leave its contents as they are.
The key was issued for another server. Give your vendor the Server ID shown above.server_idCheck that you are installing the key on the correct server. If you changed machines, see Changing servers or hardware.
This Gadka version does not support the key. Update the server.unsupportedUpdate the server.
Same message as aboveparent_missingInstall the base license before installing the additional license.
Same message as aboveperiodThe additional license expires later than the base license. Contact us.
This key has expired (including the grace period).expiredBuy a renewal.
A Standard license does not work in a container or on Kubernetes. Install Gadka on a server or VM, or choose Enterprise.platformRunning in a container with a paid license requires Enterprise. Install Gadka directly on the server or use the contact form.
This key was issued for another machine: the hardware of this installation does not match the installation code in the key.fingerprintContact us with the new installation code.

Banners on the license page

MessageMeaning
The Server ID could not be determined, so the Free edition applies.The service cannot access the machine identifier. Update the server with installer version 0.3.2 or later. See Installation code.
The Server ID changed from … to …The machine has changed. See Changing servers or hardware.
Gadka runs in a container.A container installation can run as Free or use an Enterprise license.
The license has expired (notice that the installation has returned to Free)The grace period has ended. Install a renewal.

Messages during everyday use

MessageWhen it appearsWhat to do
User limit reachedYou try to add or reactivate an account beyond the limit.Buy more seats or deactivate unused accounts.
Gadka is read-onlyThere are more active accounts than seats.Check why posting is blocked.
Workflows are available from the Standard edition.You try to use workflows in Free.Install a Standard or Enterprise key.
Federation is not included in the licenseYou try to use federation in Free.Install a Standard or Enterprise key.

Server error codes

You may see these codes in API responses and integration logs.

CodeMeaning
license_user_limit_reachedThe active account limit has been reached.
license_tenant_limit_reachedThe license does not allow another workspace.
license_restrictedThe server clock was set back. New accounts are blocked.
license_read_onlyUsers can read, but posting and most changes are blocked.
license_feature_unavailableThe feature is unavailable in this edition.
invalid_licenseThe key was rejected. Look up the reason in the first table.

The server may also log LICENSE_SERVER_ID_CHANGED when the machine changes or LICENSE_TOPOLOGY_EXCEEDED when the number of nodes exceeds the license limit.

Checking a license and contacting support