This step-by-step guide is intended to outline the main steps for the WebSpellChecker application installation on a Linux-based server with Apache Tomcat Application Server. In this guide we will run you through the whole installation process from downloading installation packages to embedding spell/grammar checking functionality to your web-based system.

Before you begin:

  • Check if your environment configuration meets the WebSpellChecker System Requirements.
  • Make sure you have a valid WebSpellChecker license.

     Click here to expand...

    First of all, you need to get a valid License Ticket ID to proceed with the license activation. Depending on the server license type, it may be a commercial or a 30-day trial license. Except the validity period, there is no difference between ticket types from the technical perspective.

    Good to know:

    • If you do not have a license yet, you can obtain it using one of the following ways:
    • WebSpellChecker license is hardware-based. Once the license is activated, it can't be reused again.
    • If you are migrating WebSpellChecker from one server to another, you need to migrate the license as well. Check carefully the WebSpellChecker application migration procedure.
    • If you have problems with your license, contact us.

1. Download Installation Package

Download WebSpellChecker application package for a corresponding version of your operating system (OS). By default, it is provided on a license purchase or maintenance renewal. You can also request it contacting us at

2. Install WebSpellChecker

2.1. Unpack the WebSpellChecker installation package (e.g. wsc_app_lix_x64_release_5.2.X.X_XX.tar.gz). Switch to the directory with the unpacked WebSpellChecker and execute the next command:

sudo perl

2.2. Select installation path. The default installation path is /opt/WSC. However, you may decide to change it and set a desired one. As soon as you defined the installation path, press Enter to proceed further.

Welcome to the WebSpellChecker (WSC) application installation wizard!
Before you go ahead with the installation, make sure that your environment configuration meets the WSC application system requirements.
If you are all set, please follow carefully the wizard instructions.
*Step 1: Change configuration settings.
Install path [/opt/WSC]:

2.3. Define permissions. Set appropriate permissions for the application. You should define the files ownership, a user and group in the user:group format (e.g. 33:33)

*Step 2: Copy the WSC files to the installation directory.
Step 3: Define the WSC application permissions.
Specify the files ownership, a user and group in the 'user:group' format.
It can be the same user and group which are used for the Apache HTTP Server, i.e. 'www-data:www-data' or '33:33'.
Specify the files owner as user:group [nobody:nobody]: 33:33

2.4. Determine network settings. Specify a service protocol, hostname, port and virtual directory which will be used to access the application.

The default ports for Apache Tomcat Application Server are 8080 and 8443 for HTTP and HTTPS protocols respectively.

*Step 4: Specify network settings.

Specify a service protocol, hostname and the virtual directory to access the WSC application.
i.e. 'http(s)://your_host_name:8080(8443)/spellcheck'

SERVICE_HOST: https://your_host_name:8443/spellcheck

The following output confirms that all the network settings have been successfully applied:

* SERVICE_HOST  = https://your_host_name:8443/spellcheck
* PROTOCOL = https
* HOST = your_host_name
* PORT = 8443
* VIRTUAL DIRECTORY = spellcheck
*Preparing the ssrv.ini configuration file.
*Installing the WSC application demo samples.
*Setting a specified service_host value in wsc_fck2plugin.js and wsc_ck2plugin.js files.

2.5. Choose Web or Application Server. The properly configured Web or Application Server is required for correct work of the application. 

  • Choose Java Application Server (Apache Tomcat, Oracle WebLogic Server, Oracle GlassFish Server, etc.) option to run WebSpellChecker on Apache Tomcat Application Server (Option 2).
Step 5: Choose Web or Application Server type.

Select a particular web or application server which will be used for the WSC application server running.

	1. Apache HTTP Server
	2. Java Application Server (Apache Tomcat, Oracle WebLogic Server, Oracle GlassFish Server, etc.)
	3. Other

Input the number from 1 to 3: 2

Here are additional required steps when installing WebSpellChecker on JavaEE Application Servers (Apache Tomcat):

  • Specify WSC_DIR environment variable. It must be pointed to the WebSpellChecker installation directory (for example, WSC_DIR=/opt/WSC).
  • Deploy WebSpellChecker on your Apache Tomcat Application Server. 
 Click here to check the WebSpellChecker Deployment Procedure...

  • Copy spellcheck.war from J2EEServersComponents to the Apache Tomcat /webapps directory.
  • Start Apache Tomcat, or stop and start if it is already running.

spellcheck.war should be automatically unpacked, otherwise unpack it manually.

3. Activate License

On this step you need to choose whether to run or not to run the license activation process. You can skip the license activation step if you already have a license activated or you prefer to proceed with the license activation step later. If you want to go ahead with the license activation, enter Yes and then proceed with the steps described in the license activation manual below.

Step 6: Activate license.

Do you want to proceed with the license activation process and run a request license? Enter yes or no [yes]: yes

 Click here to learn how to activate a license on a Linux server...

Visit Licensing WebSpellChecker on Linux guide to find out how to activate a license on a Linux server.

4. Finalize Installation

Congratulations! The WSC application has been successfully installed to /opt/WSC directory.

Step 10: Finalize the WSC application configuration under a chosen Web or Application Server:

Configure the WSC application under the Java Application Server using the next manual:

5. Configure Grammar

The new versions of WebSpellChecker Server provides multi-language grammar support.

The grammar engine requires the additional configuration steps. Please visit Enabling Grammar Engine with AppServer 5.0 to find out more how to enable grammar checking feature.

6. Verify Operability

Now you are ready to check if the installation process of the application went well and all the components are functioning properly.

Step 8: Verify the WSC application operability.

Check the application version, status and access the demo samples, to verify if the application works properly after the installation.

a. Version: https://your_host_name:8443/spellcheck/script/ssrv.cgi?cmd=ver

b. Status: https://your_host_name:8443/spellcheck/script/ssrv.cgi?cmd=status

c. Default demo samples: https://your_host_name:8443/spellcheck/samples

 Click here to expand the correct responses for the application version and status...

WebSpellChecker Server Version

Here is a correct version response for WebSpellChecker Server 5.2.0 on a Linux server:

(c) 2000-2018 WebSpellChecker LLC

All rights reserved.

Program name:ssrv
Program version:5.2.x.x x64 master:xxxxxxx (xxx) #xx for Linux

WebSpellChecker Server Status

Here is a correct status response for Spell Check, Grammar and Thesaurus engines of WebSpellChecker Server:

Spell Check Engine is ACTIVE
Grammar Engine is ACTIVE
Thesaurus Engine is ACTIVE

Please find below the description of the statuses that are received from SSRV component:

'ACTIVE' status means that an Engine works properly.
'NOT ACTIVE' status means that an Engine is not enabled or does not work properly.

For more details and assistance, please contact the technical support team at

WebSpellChecker Demo Samples

Here is correct view of the WebSpellChecker Demo Samples:

7. Integrate WebSpellChecker

Integrate WebSpellChecker products into your web application.

Option A. Integration Guides

Visit Integrating WebSpellChecker Server guides to lean more how to get started with WebSpellChecker products.

New WebSpellChecker Proofreader

Try our new product WebSpellChecker Proofreader. It is based on SpellCheckAsYouType (SCAYT) core and is designed to simplify the integration and combine functionality of proofread as you type functionality and proofread in a dialog.

Get the next benefits when using WebSpellChecker Proofreader:

  • Easy to get started. A single script for all editable fields in a web app;
  • Auto-search functionality which detects editable fields on a web page and enables proofreading functionality;
  • Proofread as you type functionality on multiply languages. Spell checking functionality is supported for 16 default languages and 152 additional languages, grammar checking functionality is available for 14 out of 16 default languages.
  • Simplified box with corrections for spelling and grammar problems. 
  • A new badge button with the WebSpellChecker Proofreader settings.
  • Supported in all modern browsers such as Chrome, Firefox, Internet Explorer 11+, MS Edge, and Safari;

Please visit Get Started with Server WSC Proofreader (autoSearch) for guidance.

Option B. Demo Samples

Depending on the type of elements (HTML native elements, rich text editors) where the spelling/grammar check functionality is needed, you may choose and use the demo samples that are shipped with the WebSpellChecker Server package accordingly. 

To access the default samples, go to the following page:  https://your_host_name:port/spellcheck/samples/. The default samples contains all the necessary samples and instructions that will help with the integration of the WebSpellChecker products. Moreover, each sample contains detailed development documentation with a list of methods and parameters available.