> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/frequently-asked-questions/installation/how-do-i-upgrade-copystorm.md).

# 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](/best-practices/copystorm-directory-structure.md), 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](/best-practices/customer-key-file-management.md) 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.