> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsiam/protect-your-endpoints/endpoint-security/install-and-manage-endpoints/manage-endpoint-protection/move-agents-between-managing-servers.md).

# Move agents between managing servers

You can move Cortex XDR agents to other Cortex XSIAM managing servers.

You can move existing agents between Cortex XSIAM managing servers directly from Cortex XSIAM. This can be useful during migration, POCs, or to better manage your agent allocation between tenants. When you change the server that manages the agent, the agent transfers to the new managing server as a freshly installed agent, without any data that was stored on the original managing server. After the Cortex XDR agent registers with the new server, it can no longer communicate with the previous one.

{% hint style="warning" %}
**Prerequisite:**

Consider the following before making changes:

* Endpoint type is not Kubernetes Node.
* Installation type is not VDI.
* Ensure you have administrator privileges for Cortex XSIAM in the hub.
  {% endhint %}

To register to another managing server, the Cortex XDR agent requires a distribution ID of an installation package on the target server in order to identify itself as a valid Cortex XDR agent. The agent must provide an ID of an installation package that matches the same operating system for the same or a previous agent version. For "same" version, this means all the levels of versioning information, including major version, minor version, patch version, and build number. For example, if you want to move a Cortex XDR Agent 8.x for Windows, you can select from the target managing server the ID of an installation package created for a Cortex XDR Agent 5.x for Windows. The operating system version can be different.

{% hint style="info" %}
**Note:**

Cortex XSIAM does not support moving agents between FedRamp and commercial tenants.
{% endhint %}

### How to move Cortex XDR agents to other managing servers

1. Obtain an installation package ID from the target managing server.
   1. Log in to Cortex XSIAM on the target management server, then navigate to **Inventory → Endpoints → Agent Installations**.
   2. From the agent installations table, locate a valid installation package you can use to register the agent. Alternatively, you can create a new installation package if required.
   3. Right-click the ID field and copy the value. Save this value, as you will need it later for the registration process. If the ID column is not displayed in the table, add it.

2. Locate the Cortex XDR agent you want to move.

   Log in to the current managing server of the Cortex XDR agent and navigate to **Inventory → Endpoints → All Endpoints**.

3. Change the managing server.
   1. Select one or more agents that you want to move to the target server.
   2. Right-click + Alt to open the options menu in advanced mode, and select **Endpoint Control → Change managing server**. This option is available only for an administrator in a supported Cortex XSIAM version.
   3. Enter the ID number of the installation package you obtained in Step 1. If you selected agents running on different operating systems, for example, Windows and Linux, you must provide an ID for each operating system. When done, click Move.

4. Track the action.

When you track the action in the Action Center, the original managing server will keep displaying In progress (Sent) status also after the action has ended successfully, since the agent no longer reports to this managing server. The new managing server will add this as a new agent registration action.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsiam/protect-your-endpoints/endpoint-security/install-and-manage-endpoints/manage-endpoint-protection/move-agents-between-managing-servers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.