> 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.

# Reconfiguring an Existing Agent

This guide describes the steps to reconfigure on-premises Moveworks Agent deployments for customers without needing to reinstall it from scratch. Whether you're updating credentials, LDAP details, or REST/Proxy configs, this guide enables you to apply configuration changes with precision.

> **Info**
>
> These Reconfiguration Enhancements have been introduced as part of Agent Version **2.10.4**
>
> Please upgrade your agent to the updated version to leverage this guide.

# 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.
* 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 Reconfiguration Process

## Via setup_agent.sh Script

You can use the **--reconfigure 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 **--reconfigure** flag you can initiate the process

```
./setup_agent.sh -r
# or
./setup_agent.sh --reconfigure
```

You can also use the **Interactive Setup Wizard**

* This uses the same script but allows you to check the existing config.

```
./setup_agent.sh --docker
...
Configuration file found. Do you want to set a new configuration? [y/n]: n
Do you want to edit the existing config file? [y/n]: y
...
Starting bond configurator with --reconfigure
```

# Configurations which can be Modified via Reconfiguration

### Secrets Provider

* You can modify values of an existing configured provider (AWS or Azure Secrets Manager). This only applies if a provider was configured at install time.
* You cannot switch providers or add a new one via reconfiguration. To add an external secrets provider to an existing deployment, a reinstall is required — see the [Installation Guide](/tool-studio/moveworks-agent/moveworks-agent-installation-guide).

### Agent Config Fields

Editable Fields:

* auth_url
* config_url
* access_key
* moveworks_access_secret
* path_to_cert
* proxy_url

### LDAP Configuration

### Single Host Mode

Reconfiguration options:

* Edit existing host configuration
* Switch to Forest Mode (optionally retain existing LDAP client config)

### Forest Mode

Reconfiguration options:

* Add LDAP host
* Edit existing host configs
* Remove LDAP hosts

**Clients are referenced by domain name** in Forest Mode. Editable Fields:

* host
* port
* domain
* service_user
* ldap_service_password
* use_ssl
* use_starttls
* path_to_cert

### REST Configs

Add, edit, or remove REST configs. Referenced by service name. Editable fields:

* service
* header_decorators (add only)
* body_decorators (add only)
* url_decorators (add only)
* do_not_use_rest_proxy
* ca_cert_path
* max_response_size
* use_ntlmv2

### Proxy Configs

Add, edit, or remove proxy entries. Each config is tied to a service. Editable fields:

* proxy_url
* port

# Saving and Persisting Configurations

* Changes are held in memory until you select \[6] Save & Exit in the prompt
* Exiting the reconfiguration mid-way will discard any saved or unsaved edits.
* Configuration updates are written to **agent_config.yml** only when saved.

---

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