***

title: Reconfiguring an Existing Agent
deprecated: false
hidden: false
metadata:
robots: index
-------------

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.

<Callout intent="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.
</Callout>

# 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](/service-management/core-platform/moveworks-agent-on-prem/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 utilises 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

* ✅ Modify values of the existing configured provider (AWS or Azure Secrets Manager). **This can only be done if you have an existing provider.**
* ❌ You cannot switch providers or add a new one as part of reconfiguration if not originally configured.

### 🛠 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. They are 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.