---
title: "Agent Update Procedure"
canonical: "https://docs.vaultspeed.com/space/VPD/3081306131/Agent%20Update%20Procedure"
format: markdown
---
With each VaultSpeed release, new features or updates may be introduced in the VaultSpeed agent. These updates will be listed in the **release notes** for each version.

**Table of Contents**

> Macro (toc)

When an update is available, follow these steps to ensure your agent is up to date:

Below are the general steps to update your VaultSpeed agent and maintain secure communication with the VaultSpeed Cloud application.

### **1. Refresh the Agent’s Credentials (Optional but Recommended)**

Refreshing credentials ensures secure and updated communication between the VaultSpeed agent and the VaultSpeed Cloud application. If the credentials are not refreshed before downloading the Agent JAR, you will need to download the JAR again, as resetting credentials generates new content for some files.

> ℹ️ Resetting credentials must be done before downloading the Agent JAR. If done afterward, you will need to download the Agent JAR again, as resetting credentials generates a new one.

#### **Steps to Refresh Agent Credentials**

1. Navigate to the **Agent **section in the VaultSpeed Cloud application.
2. Locate the **Reset Credentials** button.
3. Click **Reset Credentials** and confirm the reset.

After resetting credentials, proceed to the next step to download the new Agent JAR.

For detailed guidance, including screenshots, refer to the [Reset Agent Credentials](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/4215177222) page.

> 📝 **When Should You Refresh the Agent's Credentials?**
> 📝 
> 📝 - If the agent passphrase **has expired** or **has been compromised**, refreshing is required.
> 📝 - If the credentials are still valid, this step is optional but recommended to ensure secure and updated communication.

![4-20250205-162321.png](media://cff94ba5-9073-4a74-964d-f77a98772950)

### **2. Download the Latest Agent Version**

- Navigate to **Agent > Download JAR** in the VaultSpeed menu.
- Click **Download JAR** to download the latest agent version.

![image](media://ce35cb7d-ac10-44c9-8189-0e5ad4e9690b)


![image](media://ca56dbcd-4d0d-40cc-b2df-fd6c535e57f8)

### **3. Stop Your Current Agent**

Before updating, stop the currently running agent:

- Use the **Stop** button in the **Agent** menu in VaultSpeed.
- Or stop the agent manually from the host system.
- Verify with a **Ping Agent** that all agents are stopped.

### **4. Updating the Agent **

The update sequence varies based on whether an Agent Credential Refresh is required. Follow the appropriate steps below:

#### **If Agent Credential Refresh Is Required**

1. **Extract the ZIP file** to a temporary folder.
2. Replace the **JAR file** in the existing agent folder with the new one.
3. Copy the `oauth.secret` from the newly extracted `client.properties` file.
4. Paste the copied `oauth.secret` into the `client.properties` file in the existing agent folder.

#### **If No Agent Credential Refresh Is Required**

1. **Extract the ZIP file** to a temporary folder.
2. Replace **only** the **JAR file** in the existing agent folder with the new one.

### ** 5. Restart the Agent**

- Start the agent using your standard **“Agent Run”** procedure.
- You can also restart it from the **Agent menu** in VaultSpeed by clicking the **Start** button.
- The updated agent will automatically register its version—**no manual update is required**.

For additional guidance, refer to the **"Run the agent"** section of the [Agent Installation instructions](#).

> 📝 **Important Notes**
> 📝 
> 📝 - **Java Compatibility:** Ensure that the system is running **OpenJDK 11** or **OpenJDK 21** for compatibility, as **older versions are no longer supported**.
> 📝 - **Automatic Version Detection:** The agent now reports its version automatically, so **editing **`client.properties`** is no longer required**.