Common license errors

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

1

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:

• License activation on Windows

• License activation on Linux

2

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)

3

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 [e-mail] 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 [e-mail] 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.

This warning often doesn’t break the already activated license. Still fix it to avoid issues on reactivation/renewal.

Still stuck?

Email [e-mail].

Include:

• The exact error message

• OS and WebSpellChecker version

• Activation mode (automatic/manual)

• AppServer/Logs (zipped)

Related topics

• Connectivity / proxy

  • Internet connectivity requirements

  • License activation through proxy server

• License files and lifecycle

  • Custom path to the license file

  • Disable license auto-reactivation

  • License deactivation on Windows

  • License deactivation on Linux

• General backend troubleshooting

  • How-to troubleshoot the service issues

• Contact support

  • How do I contact support?