Common license errors

Fix common activation errors fast. Includes what to check and what to send to support.

Confirm what you’re doing

Are you activating a license right now?
Which OS are you on (Windows / Linux / Docker)?
Are you using automatic or manual activation?

If you’re not sure, check the activation guides:

Collect the basics

Copy the full error text.
Note the timestamp when it happened.
Grab AppServer logs (folder: AppServer/Logs).

To verify the current license status in logs, use:

License verification
Main AppServer commands (status/version checks)

If you use automatic activation, verify outbound connectivity

Automatic activation requires outbound access to WebSpellChecker licensing API.

Make sure your server can reach the Internet.
Check firewall / proxy rules.
See the exact endpoint and allowlist notes in:
- Internet connectivity requirements

If you activate through a proxy:

License activation through proxy server

Activation error messages

Open the exact message you see and follow the steps.

Error. The License Ticket ID that you have entered is incorrect or invalid. Please recheck your Ticket and try again.

What it means

The License Ticket ID was not accepted by the licensing server.

Fix

Re-copy the License Ticket ID.
Avoid leading/trailing spaces and line breaks.
Make sure you’re using the ticket for the correct product/environment.
If you upgraded from very old versions, confirm you’re not using a legacy license type.

If it still fails

Email support@webspellchecker.net and include:

the License Ticket ID you used
the exact error message
OS and WebSpellChecker version

Error. Unable to connect to the remote license server. The automatic license activation has failed. Check your Internet connection or try to activate your license manually.

What it means

Your server can’t reach the licensing endpoint during automatic activation.

Fix

Verify outbound access from the server.
Check firewall rules, proxy, DNS, and SSL inspection.
Allowlist the licensing endpoint mentioned in:
- Internet connectivity requirements
If the server has no Internet access, switch to manual activation:
- License activation on Windows
- License activation on Linux

If you’re behind a proxy

License activation through proxy server

Error. License decoding failed. Invalid or corrupted license string. Verify and retry.

What it means

This is a manual activation issue. The License Response string is incomplete or altered.

Fix

Re-copy the entire License Response string.
Don’t remove URL-encoded characters.
Avoid leading/trailing spaces and line breaks.
Make sure you didn’t paste only part of the string.

If you’re copy/pasting through terminals, disable “smart” formatting tools.

Error. The license activation has failed. You have exceeded the maximum allowed number of attempts to activate the license.

What it means

There is a fixed limit for activation attempts per License Ticket ID.

Fix

Contact support to increase attempts.
If you’re using Docker, activate during the image build or persist the license in the image.

Send to support

License Ticket ID
Number of installations/activations you already ran

Error. The license activation has failed. Your license expired.

What it means

The License Ticket ID is no longer valid.

Fix

Check if your team has a newer License Ticket ID.
If not, contact support@webspellchecker.net to renew.

Send to support

License Ticket ID

Warning. Failed to update information in the license file. System exception.

What it means

AppServer couldn’t update the local license file on disk.

Fix

Check write permissions for the license storage directory:
- Windows: C:\ProgramData\WebSpellChecker
- Linux: /var/lib/WebSpellChecker
If you run as a service, verify the service user has access.
On Docker, make sure the mounted volume is writable.