--- title: "Change agent-server communication port" slug: "change-agent-server-communication-port" tags: ["Product Usage", "ePolicy Orchestrator – On-prem", "ePO 5.10.x", "ePO 5.10.0"] updated: 2026-09-08T10:31:39Z published: 2026-09-08T10:31:39Z canonical: "docs.trellix.com/change-agent-server-communication-port" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Change agent-server communication port Follow these steps to change the agent-server communication port. > [!WARNING] > Important > > This topic contains information about opening or modifying the registry. This information is for network and system administrators only. Registry modifications are irreversible and can cause system failure if done incorrectly. - We strongly recommend that you back up your registry and understand the restore process. For more information, see the Microsoft documentation. - Make sure that you run only .REG files that are confirmed to be genuine registry import files. Modifying the agent-server communication port requires five steps and one optional step if you are using remote **Agent Handlers**. 1. Stop the ePO - On-prem services 2. Modify the port value in the registry 3. Modify the value in the ePO - On-prem database 4. Modify the port value in the ePO - On-prem configuration files 5. Restart the ePO - On-prem services 6. **(Optional)** Modify settings on remote Agent Handlers For details about product features, usage, and best practices, click ? or Help. 1. Stop the ePO - On-prem services: 1. Close all ePO - On-prem consoles. 2. Click **Start** → **Run**, type `services.msc`, then click **OK**. 3. Right-click each of these services and select **Stop**: - **Trellix ePolicy Orchestrator Application Server** - **Trellix ePolicy Orchestrator Event Parser** - **Trellix ePolicy Orchestrator Server** 2. Modify the port value in the registry: 1. Click **Start** → **Run**, type `regedit`, then click **OK**. 2. Navigate to the key that corresponds to ePO - On-prem: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{ 53B73DFD-AFBE-4715-88A1-777FE404B6AF}] 3. Modify the string value `AgentPort` to reflect the appropriate port, then close the registry editor. The default value for this port is `80`. 3. Modify the value in the ePO - On-prem database: 1. Open a text editor, and add these lines to the blank document: ```plaintext UPDATE EPOServerInfo ServerHTTPPort=80 ``` 2. Save the file as **DefaultAgentPort.SQL** in a temporary location on the SQL Server. 3. Click **Start** → **All Programs** → **Microsoft SQL Server Management Studio** to use Microsoft SQL Server Management Studio to install the DefaultAgentPort.sql file. 4. On the **Connect to Server** dialog box, click **Connect**. 5. Expand **Databases**, then select **ePO database**. 6. From the toolbar, select **New Query**. 7. Click **File** → **Open** → **File**, browse to and select the DefaultAgent.SQL file, then click **Open** → **Execute.** 8. Paste this line into a blank document: ```plaintext UPDATE EPOServerInfo SET ServerHTTPPort =80 ``` Change `80` to the new port number. 9. Name the file `DefaultAgentPort.SQL` and save it to a temporary location on the SQL Server. 10. Use Microsoft SQL Server Management Studio to install the `DefaultAgentPort.SQL` file. - Click **Start** → **All Programs** → **Microsoft SQL Server Management Studio**. - On the **Connect to Server** dialog box, click **Connect**. - Expand **Databases**, then select **ePO database**. - From the toolbar, select **New Query**. - Click **File** → **Open** → **File**, browse to and select the DefaultAgentPort.SQL file, then click **Open** → **Execute.** 4. Modify the port value in the ePO - On-prem configuration files: 1. Navigate to `C:\Program Files (x86)\McAfee\ePolicy Orchestrator\DB\....` 2. Using a text editor, open Server.ini and change the value for `HTTPPort=80` to reflect the new number, then save the file. 3. Using a text editor, open Siteinfo.ini and change the value for `HTTPPort=80` to reflect the new number, then save the file. 4. Navigate to `C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Apache2\conf\...`, open httpd.conf, then change these lines to reflect the new port number: ```plaintext Listen 80 ServerName: 80 ``` If using VirtualHosts, change: ```plaintext NameVirtualHost *:80 ``` 5. Save the file and exit the text editor. 5. Restart the ePO - On-prem services: 1. Click **Start** → **Run**, type `services.msc`, then click **OK**. 2. Right-click each of these services and select **Start**: - **Trellix ePolicy Orchestrator Application Server** - **Trellix ePolicy Orchestrator Event Parser** - **Trellix ePolicy Orchestrator Server** 6. (Optional) Modify settings on remote Agent Handlers: 1. Make sure that all ePO - On-prem consoles are closed, then click **Start** → **Run**, type `services.msc` and click **OK**. 2. Right-click each of these services and select **Start**: - **Trellix ePolicy Orchestrator Event Parser** - **Trellix ePolicy Orchestrator Server** > [!NOTE] > Note > > This server might be listed as MCAFEEAPACHESRV if the server wasn't restarted since the Agent Handler was installed. 3. Navigate to `C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Apache2\conf\...`, using a text editor open **httpd.conf**, then change these lines to reflect the new port number: ```plaintext Listen 80 ServerName: 80 ``` If using VirtualHosts, change: ```plaintext NameVirtualHost *:80 ``` 4. Save the file and exit the text editor. 5. Click **Start** → **Run**, type `services.msc`, then click **OK**. 6. Right-click each of these services and select **Start**. - **Trellix ePolicy Orchestrator Event Parser** - **Trellix ePolicy Orchestrator Server** > [!NOTE] > Note > > This server might be listed as MCAFEEAPACHESRV if the server has not been restarted since the Agent Handler was installed. If you previously deployed agents to clients, reinstall the agent on all clients using the /forceinstall switch to overwrite the existing Sitelist.xml file. For more information about specific Trellix Agent versions that allow the /forceinstall switch to work successfully, see Trellix KnowledgeBase article [KB60555](https://support.trellix.com/s/article/KB60555).