> This page is for Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Upgrading an Existing Agent Version

This guide describes the steps to upgrade on-premises Moveworks Agent deployments.

# Prerequisites

* Ensure that the Moveworks Agent is already installed and running on your on-prem network.
* You must have access to the **setup_agent.sh script** in the Docker/Podman container where the agent is deployed. If you do not see the setup_agent.sh script, follow these steps to install the script:
  1. Download the agent installation script using curl or wget:
     1. ```shell
        curl -fsSL https://get-agent.moveworks.com > setup_agent.sh
        ```
        ```shell
        wget https://get-agent.moveworks.com/ --output-document setup_agent.sh
        ```
  2. Set the script's permissions to allow execution:
     1. ```shell
        chmod +x setup_agent.sh
        ```
* Refer to the [Moveworks Agent Installation Guide](/tool-studio/moveworks-agent/moveworks-agent-installation-guide) if you need to deploy a new Agent.

# How To Initiate the Agent Upgrade Process

You can use the **--upgrade** flag to kick off the process:

* Log into the VM or Host where the Agent Container is running. You should find the **setup_agent.sh** in the **moveworks_agent** folder
* Using the **--upgrade** flag you can initiate the process

```
./setup_agent.sh -u
# or
./setup_agent.sh --upgrade
```

The upgrade script will stop all running agents, pull the latest image, and restart the containers. To verify available version tags before upgrading, check the [Moveworks ECR Public Gallery](https://gallery.ecr.aws/moveworks/agent).

---

For questions or issues, please reach out to your Moveworks Support Team.