Move the Okta AD Agent to a Different Server
Dec 16, 2025
Okta Classic Engine
Directories
Okta Identity Engine
Overview
This article describes how to move the AD Agent to a different server.
Applies To
- Okta AD Agent
- Active Directory
- Decommissioning an old Okta AD Agent
Cause
A lot of situations require a change of servers and the need to move the AD Agent comes into view.
Solution
Moving an AD Agent is not a literal transfer; it is the process of installing a new Agent and then decommissioning the original. Before anything else, ensure all AD Agent requirements are satisfied. Once confirmed, please follow the steps below:
- Install the new AD Agent on the new server.
- If an Okta service account was created during the first Okta AD agent installation, the password must be provided during the second Okta AD agent installation. It is recommended to install the latest version available on the Okta Admin Dashboard.
- Uninstall the old AD Agent from the decommissioned server.
- Select Directory - Directory Integrations.
- Click Active Directory and the Agents tab.
- Confirm that the reinstalled Okta AD agent appears in the Agent Monitors section and is connected to Okta. At least one Okta AD agent should be online.
This method ensures that there is no downtime as the new installation occurs before the decommissioning of the old AD Agent.
