# Update Cover

Diffblue releases product updates about every two weeks to continuously provide you with product enhancements and new features. Note that:

* If needed, check the details for the latest updates, and even the older ones - see [What's new](/updates-and-upgrades/whats-new.md).
* When you update, you'll always be updated to the latest version.
* If you're using Cover Plugin **and** Cover CLI, we recommend that you update both products to the latest version.

## Update Cover Plugin or Cover CLI

{% tabs %}
{% tab title="Cover Plugin" %}
{% hint style="info" %}
Updating Cover Plugin may take a few minutes to complete and will require an IDE restart - you won't be able to create any tests for your projects while the update is progressing.
{% endhint %}

1. In IntelliJ, go to `File > Settings > Plugins` (Windows/Linux) or `IntelliJ IDEA > Preferences > Plugins` (macOS), highlight the Diffblue Plugin and click `Update` in the details panel.
2. When you're ready, click `Restart IDE` to complete the update. Enjoy your shiny, new plugin.
   {% endtab %}

{% tab title="Cover CLI" %}
{% hint style="info" %}
Updating Cover CLI may take a few minutes to complete and you won't be able to create any tests for your projects while the update is progressing.
{% endhint %}

**Windows:**

1. Using the link provided by Diffblue, download the new Diffblue Cover CLI file - either the `.exe` installer or `.zip` archive, as needed.
2. If you use the installer, run the `.exe` installer and follow the on-screen prompts.
3. If you use the archive file, extract the `.zip` file to your existing Cover CLI folder.
4. When your done, restart your PC.

**Linux/macOS:**

1. Using the link provided by Diffblue, download the Diffblue Cover CLI `.zip` file.
2. Unzip the Cover CLI zip file to an appropriate installation location (for example, `~/bin`) and update this location in the `PATH` environment variable using the following example commands:\\

   ```
   mkdir ~/bin
   cd ~/bin
   unzip ~/diffblue-cover*.zip
   cd
   export PATH=$PATH:~/bin
   ```

   \
   **Reminder:** Make sure that the `PATH` environment variable is set permanently according to your operating system instructions.
   {% endtab %}
   {% endtabs %}

## Update Cover Reports

{% hint style="info" %}
Updating Cover Reports may take some time to complete. During this time you won't be able to upload new reports bundles and the Reports URL won't be accessible.
{% endhint %}

{% tabs %}
{% tab title="Docker" %}
On your Cover Reports server:

1. Stop Cover Reports by running: `docker compose down`
2. In your shell, navigate to the `$COVER_REPORTS_HOME` directory where the existing installation is located and make a copy (backup) of the directory.
3. Rename the `docker-compose.yml` file in the `$COVER_REPORTS_HOME` directory - e.g. `docker-compose-2023.08.13.yml`
4. Using the link provided by Diffblue, download Cover Reports:\
   \&#xNAN;**-** For Cover Reports Docker Compose, download the `docker-compose.yml` file to the `$COVER_REPORTS_HOME` directory.\
   \&#xNAN;**-** For Cover Reports `.tar.gz`, download the latest Cover Reports bundle (e.g. `diffblue-cover-reports-2023.08.01.tar.gz`) and load the Docker bundle:\
   `docker load -i /path/diffblue-cover-reports-<version>.tar.gz`
5. Start the new version of Cover Reports using the command: `docker compose up -d`
   {% endtab %}

{% tab title="ZIP Install" %}

1. Make a copy of your custom files as needed - `application.properties`, `cover-reports.xml`, `cover-reports.service`
2. Using the link provided by Diffblue, download the latest Cover Reports `.zip` bundle to your Cover Reports install directory.
3. Stop Cover Reports (if currently running).
4. In your shell, navigate to the Cover Reports install directory and extract the contents of the downloaded zip file.
5. Add your custom files back to the updated installation.
6. Restart Cover Reports.
   {% endtab %}

{% tab title="EXE Install" %}
**Windows:**

1. Using the link provided by Diffblue, download the combined Cover CLI & Cover Reports - for example, `diffblue-cover-installer-2023.10.02.exe`
2. Using the Windows Service Manager, stop the **Cover Reports** service.
3. Run the installer and follow the on screen prompts - note that to install Cover Reports, make sure that the `Cover Reports` option is selected during the install.
4. Restart the **Cover Reports** service.
   {% endtab %}
   {% endtabs %}


---

# 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://cover-docs.diffblue.com/updates-and-upgrades/update-cover.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.