> For the complete documentation index, see [llms.txt](https://docs.wproofreader.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wproofreader.com/v6.11.1/deployment/installation/upgrade-application-version.md).

# Upgrade application version

This step-by-step guide is intended to outline the main steps for WebSpellChecker Server upgrade and reinstallation on the same server (hardware).

* If you plan to reinstall package v.5.4.0-5.7.1 on a different server, you need to **deactivate** a license first and activate it on a different server later. For details, refer to License Deactivation on [Windows](https://docs.webspellchecker.net/display/WSDK/License+deactivation+on+Windows) and [Linux](https://docs.webspellchecker.net/display/WSDK/License+deactivation+on+Linux) guides.
* If you are reinstalling the application on the same server, you must **skip** the license activation step.<br>
* [1. Stop AppServer](#draft-upgradeapplicationversion-1.stopappserver)
* [2. Back up Existing Setup Configuration and Files](#draft-upgradeapplicationversion-2.backupexistingsetupconfigurationandfiles)
  * 2.1. Files backup on Windows
  * 2.2. Files backup on Linux
* [3. Install a New Version of WebSpellChecker Server](#draft-upgradeapplicationversion-3.installanewversionofwebspellcheckerserver)
* [4.Start AppServer](#4.-start-appserver)
* [5. Verify Operability](#draft-upgradeapplicationversion-5.verifyoperability)

### 1. Stop AppServer <a href="#draft-upgradeapplicationversion-1.stopappserver" id="draft-upgradeapplicationversion-1.stopappserver"></a>

It is recommended to [stop AppServer](https://docs.wproofreader.com/v6.11.1/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-stopappserverwindowslinux2.stopappserver) of the existing installation before launching a new setup.

### **2. Back up Existing Setup Configuration and Files** <a href="#draft-upgradeapplicationversion-2.backupexistingsetupconfigurationandfiles" id="draft-upgradeapplicationversion-2.backupexistingsetupconfigurationandfiles"></a>

Comments below apply to reinstallation and upgrade of WebSpellChecker Server on the same server.

**2.1. Files backup on Windows**

When reinstalling WebSpellChecker Server on **Windows**, the installer tries to auto-detect if any other versions of the package already exist. Select the **Backup WebSpellChecker files** option to back up any already existing configurations and other files.

Once you select the **Backup the WebSpellChecker files** option, settings files as well as dictionaries will be saved to **C:\Program Files\WebSpellChecker\\.Backup**.

<figure><img src="/files/hQ1euBUjwpmBFqAwnq8P" alt=""><figcaption></figcaption></figure>

**2.2. Files backup on Linux**

When reinstalling WebSpellChecker Server on the same server on **Linux**, a directory containing files and dictionaries settings will be rewritten, and a backup copy will be created. During this rewriting process, a directory containing User and Server Custom Global dictionaries unique contents and their settings is saved. The default backup directory is **/opt/WSC/.Backup**.

### 3. Install a New Version of WebSpellChecker Server <a href="#draft-upgradeapplicationversion-3.installanewversionofwebspellcheckerserver" id="draft-upgradeapplicationversion-3.installanewversionofwebspellcheckerserver"></a>

Install a new version of the application following the steps from the appropriate [manual](/v6.11.1/deployment/installation.md).

### 4. Start AppServer

Once you completed all the upgrade/reinstallation steps, you need to [start AppServer](https://docs.wproofreader.com/v6.11.1/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-startappserverwindowslinux1.startappserver) of your new installation.

### 5. Verify Operability <a href="#draft-upgradeapplicationversion-5.verifyoperability" id="draft-upgradeapplicationversion-5.verifyoperability"></a>

5.1 Check the status and the version of the new installation to verify if it works properly:

* [AppServer version](https://docs.wproofreader.com/v6.11.1/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-3.checkappserverversion)
* [AppServer status](https://docs.wproofreader.com/v6.11.1/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-4.checkappserverstatus)

5.2 Check if grammar and spelling functionality works correctly after the upgrade/reinstallation in your web application, namely:

* Grammar and spelling are checked, incorrect words are underlined, and so on.
* User interface buttons and dialog windows are displayed correctly.