All versions of WebSpellChecker package up to up to v5.8.0 are shipped with hardware-based licenses. Refer to the steps described in this section in the following cases: 

  • changing a MAC address
  • updating the network interface
  • migrating to another environment 
  • performing some hardware manipulations affecting WebSpellChecker application/ license. 

1. Deactivate license

As of release 5.4.0 in April 2019, a new licensing flow was introduced. It provides ability of a license deactivation with the further reactivation on a new server without contacting the support and requesting a temporary license.

License deactivation on Linux

This guide outlines how to deactivate a license of WebSpellChecker Server installed on a Linux server. After a successful license deactivation, you can reuse a license with a fresh installation on a new server. 

1. Run the deactivateLicense.sh script using the following command below:

sudo sh /<WebSpellChecker_Installation_Dir>/WSC/AppServer/deactivateLicense.sh

Or you can also run AppServerX with -deactivateLicense parameter.

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# ./AppServerX -deactivateLicense

Alternatively, for a silent automatic license deactivation, you can run AppServerX with -deactivateLicense and -y parameters as follows:

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# ./AppServerX -deactivateLicense -y

2. Select either automatic or manual license deactivation mode.

Option A: Automatic license deactivation

2.1. If you prefer to deactivate a license automatically, and Internet connection is available on your machine, press Enter. Automatic license deactivation is provided by default.

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# ./AppServerX -deactivateLicense

Do you want the installer to attempt to deactivate your license automatically? 
The automatic deactivation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual deactivation instead.
Enter 'y' or 'n' [y]: y

Congratulations! Your License Ticket ID '***************' has been deactivated successfully. Now you can reuse this license with a fresh installation.

If no valid license is found, you will get the following error: 

Error. Failed to deactivate the license. No valid license is found on this machine.

Option B: Manual license activation

2.1. If your machine doesn't have the Internet connection configured, select manual license deactivation mode by typing 'n'.

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# ./AppServerX -deactivateLicense

Do you want the installer to attempt to deactivate your license automatically? 
The automatic deactivation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual deactivation instead.
Enter 'y' or 'n' [y]: n

Deactivate License by copying and pasting the next Deactivation link into the browser window: 
https://webspellchecker.com/api/licensing/v1/process-license?data=3:SCvdn4AFLiB6pQXSYv9/zTRxxLIwhzjjKiAUx2KKvv8jzmw90s3KI964fe0DuT/Xwm4EtqTsc/m68bRtdw/GfZxuA0X3eVH5Som613HNlQ0RFxZd1JJ2hOLOhhZ2Rv%2BlWxLSQsUvW0QRJsf5u1DVZH9R=

2.2. Once the manual license deactivation mode is selected, a Deactivation link will be generated based on your current License Ticket ID and unique machine hardware characteristics.

Use this Deactivation link to deactivate license. Copy the entire Deactivation link and paste it into the browser window on the machine with the Internet connection. If the used Deactivation link is valid, the license will be deactivated successfully.

The following message will be shown in the browser window:

Congratulations! Your License Ticket ID '***************' has been deactivated successfully. Now you can reuse this license with a fresh installation.

If no valid license is found, you will get the following error message: 

Error. Failed to deactivate the license. No valid license is found on this machine.

License deactivation on Windows

This guide outlines how to deactivate a license of WebSpellChecker Server installed on a Windows server. After a successful license deactivation, you can reuse a license with a fresh installation on a new server. 

1. Launch Deactivate License service. You can launch license deactivation service either directly from Windows graphic user interface (GUI) or using command line interface (Command Prompt). Both ways are described in this section.

Option A: Windows GUI

Go to Windows Start –> All Programs –> WebSpellChecker –> AppServer –> Deactivate License

Option B: Command Prompt

Open Command Prompt –> Switch to [WebSpellChecker_Installation_Path]/AppServer –> Run AppServerX.exe -deactivateLicense

Alternatively, you can execute AppServerX.exe with -deactivateLicense and -y  parameters as follows for a silent automatic license deactivation:

AppServerX.exe -deactivateLicense -y

2. Select the license deactivation mode. You can choose between automatic or manual license deactivation mode.

Option A: Automatic License Deactivation

2.1. If you prefer to deactivate license automatically, and Internet connection is available on your machine, press Enter. The automatic license deactivation is provided by default.

.../AppServerX.exe -deactivateLicense

Do you want the installer to attempt to deactivate your license automatically? 
The automatic deactivation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual deactivation instead.
Enter 'y' or 'n' [y]: y

Congratulations! Your License Ticket ID '***************' has been deactivated successfully. Now you can reuse this license with a fresh installation.

If no valid license is found, you will get the following error: 

Error. Failed to deactivate the license. No valid license is found on this machine.

Option B: Manual License Deactivation

2.1. If your machine doesn't have Internet connection configured, select manual license deactivation mode by typing 'n'.

.../AppServerX.exe -deactivateLicense

Do you want the installer to attempt to deactivate your license automatically? The automatic deactivation requires the Internet connection available on this machine. Otherwise, please proceed with the manual deactivation instead.
Enter 'y' or 'n' [y]: n

Deactivate License by copying and pasting the next Deactivation link into the browser window: 
https://webspellchecker.com/api/licensing/v1/process-license?data=3:SCvdn4AFLiB6pQXSYv9/zTRxxLIwhzjjKiAUx2KKvv8jzmw90s3KI964fe0DuT/Xwm4EtqTsc/m68bRtdw/GfZxuA0X3eVH5Som613HNlQ0RFxZd1JJ2hOLOhhZ2Rv%2BlWxLSQsUvW0QRJsf5u1DVZH9R=

2.2. Once the manual license deactivation mode is selected, a Deactivation link will be generated based on your current License Ticker ID and unique machine hardware characteristics.

Use this Deactivation link to deactivate license. Copy the entire Deactivation link and past into the browser window on the machine with the Internet connection. If the used Deactivation link is valid, the license will be deactivated successfully. The following message will be shown in the browser window:

Congratulations! Your License Ticket ID '***************' has been deactivated successfully. Now you can reuse this license with a fresh installation.

If no valid license is found, you will get the following error:

Error. Failed to deactivate the license. No valid license is found on this machine.

2. Install WebSpellChecker

Depending on the type of the environment where you are migrating the application, refer to one of the installation manuals below.

Installing WebSpellChecker Server on a Windows server

Installing WebSpellChecker Server on a Linux server

3. Reactivate license

As soon as you completed the main installation steps, reactivate your License Ticket ID on a new server.

License activation on Linux

As soon as the installation process is completed, you are required to activate a license to start using the application. Below you can find a step-by-step manual for the license activation on a Linux server.

To proceed with the license activation, you need to get a valid license ticket Id

Good to know:

  1. information.If you do not have a license yet, you can obtain it using one of the following ways:
    1. request a 30-day trial license for evaluation and testing purposes;
    2. acquire a commercial license by contacting our sales department.
  2. Depending on the server license type, it may be a commercial (1-year) or a 30-day trial license. Except the validity period, there is no difference between ticket types from the technical perspective.
  3. There is a mechanism of license reactivation available. There will be a set of attempts to reactivate a license automatically that is about to expire (7 days, 1 day, 1 hour and 10 minutes before expiration). All the attempts and their status will be recorded in the log files. This can be disabled, for more details visit Disable license auto-reactivation.
  4. Starting from v5.8.1 released on December 30, 2020, the license is no longer validated by or tied to the hardware characteristics of a machine or server. License for older versions of the packages is hardware-dependent and require license migration procedure if you are migrating WebSpellChecker from one server to another. Refer to the license migration procedure for details.
  5. If a firewall and proxy server is used to handle the inbound/outbound traffic to your network, please check License activation through proxy server for additional information.
  6. If you have problems with your license, contact our technical team.

1. Run the activateLicense.sh script to launch License Service using the following command below:

sudo sh /<WebSpellChecker_Installation_Dir>/WSC/AppServer/activateLicense.sh

Or your can also run AppServerX with -activateLicense parameter.

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# ./AppServerX -activateLicense

2. Specify your License Ticket ID. It may be a 30-day trial or a 1-year commercial license ticket that you received after the trial version request or after purchasing the license respectively.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

If you enter a License Ticket ID that is incorrect or invalid, you will get the following error:

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

To solve the issue, recheck your License Ticket ID and try again.

3. Select the license activation mode. There are two modes available for the license activation which is automatic and manual described below:

Automatic license activation mode requires Internet connection on the machine where you are trying to install WebSpellChecker.

Option A: Automatic License Activation

3.1. If you prefer to activate license automatically, and Internet connection is available on your machine, press Enter. Automatic license activation is provided by default.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]:

Congratulations! Your license is confirmed and activated successfully.

If the Internet connection is absent on a machine where you are trying to activate a license automatically, you will get the following error: 

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.

 Either resolve the issue with the connection on the machine or try to activate license manually. 

Option B: Manual License Activation

3.1. If your machine doesn't have Internet connection configured, select manual license activation mode by typing 'n'.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]: n

3.2. Once the manual license activation mode is selected, a License Request link will be generated based on a License Ticket ID specified and unique machine hardware characteristics. Use this License Request link to obtain a License Response string. Copy the entire License Request link and paste it into the browser window on the machine with Internet connection. If the used License Ticket ID and the License Request link are valid, you will receive a License Response string generated by our License Server.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]: n

Obtain a License Response string by copying and pasting the next License Request link into the browser window: 
https://webspellchecker.com/api/licensing/v1/process-license?data=3:PkDzeo2t7mBaATUFE9PWdJjWZkdsjJFpzwUFZjCIC4ObVstHdPuOcVjT5HRGWjGvXumnouD3Tz1k3W42uFnR8EAO2564fXKDc4UHjTuU46EcZde%2BaRUI9c2c=

3.3. Copy the License Response string generated in the browser window and paste intro the command line as your License Response. If the License Response that you entered is valid, you will receive a confirmation of the successful license activation.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]: n

Obtain a License Response string by copying and pasting the next License Request link into the browser window: 
https://webspellchecker.com/api/licensing/v1/process-license?data=3:PkDzeo2t7mBaATUFE9PWdJjWZkdsjJFpzwUFZjCIC4ObVstHdPuOcVjT5HRGWjGvXumnouD3Tz1k3W42uFnR8EAO2564fXKDc4UHjTuU46EcZde%2BaRUI9c2c=

Enter your License Response: 3:gaqbnSEaEHRC9%2Bqq%2BSpFkJek1ig0Rm7BzD3R5Paqq%2BNPDZcNEUe0Kt1w648GrLqrSI9XgmeKoJCB1bfQ/zGH/Q9pSgaJVhzklho5DNmDGhDQMZmVKVa2yKr7N006W1XcWXF3P/0FaZK%2Bh9K5MvvzxoNpU=

Congratulations! Your license is confirmed and activated successfully.


If after checking all the license details and performing all the described steps, you are unable to get the license activated properly, contact us at [email protected] and describe the problem.

License activation on Windows

As soon as the installation process is completed, you are required to activate a license to start using WebSpellChecker. Below you can find a step-by-step manual for license activation on a Windows-based environment.

To proceed with the license activation, you need to get a valid license ticket Id

Good to know:

  1. information.If you do not have a license yet, you can obtain it using one of the following ways:
    1. request a 30-day trial license for evaluation and testing purposes;
    2. acquire a commercial license by contacting our sales department.
  2. Depending on the server license type, it may be a commercial (1-year) or a 30-day trial license. Except the validity period, there is no difference between ticket types from the technical perspective.
  3. There is a mechanism of license reactivation available. There will be a set of attempts to reactivate a license automatically that is about to expire (7 days, 1 day, 1 hour and 10 minutes before expiration). All the attempts and their status will be recorded in the log files. This can be disabled, for more details visit Disable license auto-reactivation.
  4. Starting from v5.8.1 released on December 30, 2020, the license is no longer validated by or tied to the hardware characteristics of a machine or server. License for older versions of the packages is hardware-dependent and require license migration procedure if you are migrating WebSpellChecker from one server to another. Refer to the license migration procedure for details.
  5. If a firewall and proxy server is used to handle the inbound/outbound traffic to your network, please check License activation through proxy server for additional information.
  6. If you have problems with your license, contact our technical team.

1. Launch WebSpellChecker License Service. You can launch WebSpellChecker License Service either directly from Windows graphic user interface (GUI) or using command line interface (Command Prompt). Both ways are described in this section.

Option A: Windows GUI

Go to Windows Start –> All Programs –> WebSpellChecker –> AppServer –> Activate License

Option B: Command Prompt

Open Command Prompt –> Switch to [WebSpellChecker_Installation_Path]/AppServer –> Run AppServerX.exe -activateLicense

Alternatively, for a silent automatic license activation, you can execute AppServerX.exe with two parameters -activateLicense [License Ticket ID] and -y as follows:

AppServerX.exe -activateLicense *************** -y

2. Specify your License Ticket ID. It may be a 30-day trial or a 1-year commercial license ticket that you received on the trial version request or after purchasing the license respectively.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

If you enter a License Ticket ID that is incorrect or invalid, you will get the following error:

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

To solve the issue, recheck your License Ticket ID and try again.

3. Select the license activation mode. There are two modes available for the license activation which is automatic and manual described below:

Automatic license activation mode requires the Internet connection available on the machine where you are trying to install WebSpellChecker.

Option A: Automatic License Activation

3.1. If you prefer to activate license automatically, and Internet connection is available on your machine, press Enter. Automatic license activation is provided by default.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]:

Congratulations! Your license is confirmed and activated successfully.

If the Internet connection is absent on a machine where you are trying to activate a license automatically, you will get the following error: 

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.

Either resolve the issue with the connection on this machine or try to activate the license manually. 

Option B: Manual License Activation

3.1. If your machine doesn't have the Internet connection configured, please select the manual license activation mode by typing 'n'.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]: n

3.2. Once the manual license activation mode is selected, a License Request link will be generated based on a License Ticket ID specified and unique machine hardware characteristics. Use this License Request link to obtain a License Response string. Copy the entire License Request link and past into the browser window on the machine with the Internet connection. If the used License Ticket ID and the License Request link are valid, you will receive a License Response string generated by our License Server.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]: n

Obtain a License Response string by copying and pasting the next License Request link into the browser window: 
https://webspellchecker.com/api/licensing/v1/process-license?data=3:PkDzeo2t7mBaATUFE9PWdJjWZkdsjJFpzwUFZjCIC4ObVstHdPuOcVjT5HRGWjGvXumnouD3Tz1k3W42uFnR8EAO2564fXKDc4UHjTuU46EcZde%2BaRUI9c2c=

3.3. Copy the License Response string generated in the browser window, and paste intro the command line as your License Response. If the License Response that you entered is valid, you will receive a confirmation of the successful license activation.

Do you want to proceed with the license activation process and run a request license?
Enter 'y' or 'n' [y]: y
Specify your License Ticket ID: ***************

Do you want the installer to attempt to activate your license automatically? 
The automatic activation requires the Internet connection available on this machine. 
Otherwise, please proceed with the manual activation instead. Enter 'y' or 'n'. [y]: n

Obtain a License Response string by copying and pasting the next License Request link into the browser window: 
https://webspellchecker.com/api/licensing/v1/process-license?data=3:PkDzeo2t7mBaATUFE9PWdJjWZkdsjJFpzwUFZjCIC4ObVstHdPuOcVjT5HRGWjGvXumnouD3Tz1k3W42uFnR8EAO2564fXKDc4UHjTuU46EcZde%2BaRUI9c2c=

Enter your License Response: 3:gaqbnSEaEHRC9%2Bqq%2BSpFkJek1ig0Rm7BzD3R5Paqq%2BNPDZcNEUe0Kt1w648GrLqrSI9XgmeKoJCB1bfQ/zGH/Q9pSgaJVhzklho5DNmDGhDQMZmVKVa2yKr7N006W1XcWXF3P/0FaZK%2Bh9K5MvvzxoNpU=

Congratulations! Your license is confirmed and activated successfully.


If after checking all the license details and performing all the described steps, you are unable to get the license activated properly, contact us at [email protected] describing the problem.