# How Do I Upgrade CopyStorm?

Upgrading CopyStorm can be a simple task if you follow one rule:

* Do not store site specific customizations or configuration files in the CopyStorm distribution directory.

If you have set up your Capstorm software by following our [Best Practice Guide](https://learn.capstorm.com/best-practices/copystorm-directory-structure), you should be ready to continue with the upgrade. If you have included site specific files in the CopyStorm distribution directory then move them into their own directory before starting the upgrade.

To upgrade a CopyStorm installation:

* Download the latest CopyStorm release from <https://www.capstorm.com/download>
* Rename the existing CopyStorm root directory to a new name.
* Unzip the CopyStorm distribution archive.
* Move the unzipped CopyStorm directory to the same location as your previous CopyStorm installation.
* Copy any site-specific configuration files from the previous installation directory to the newly moved installation directory.
  * Be sure to include the [CapstormCustomerKey.txt](https://learn.capstorm.com/best-practices/customer-key-file-management) file, if it is installed in the CopyStorm product directory.

You’re finished! CopyStorm distributions have always been backwards compatible with configuration files from previous versions so there is nothing else to change.

**WARNING: DO NOT unzip a CopyStorm distribution over an existing installation of CopyStorm.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.capstorm.com/frequently-asked-questions/installation/how-do-i-upgrade-copystorm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.