How to Change the Veeam Reverse Proxy Service Port (443) After Deployment
| KB ID: | 4899 |
| Product: | Veeam Backup & Replication | 13 | 13.1 |
| Published: | 2026-11-03 |
| Last Modified: | 2026-11-03 |
Purpose
This article documents how to adjust the Primary service port (default 443) on a Windows-based Veeam Backup & Replication deployment after installation, and how to update the remote consoles that connect to it.
Starting in Veeam Backup & Replication 13.1, the software consolidates client service traffic behind the Veeam Reverse Proxy Service, which listens on port 443, by default. During initial deployment of Veeam Backup & Replication, the Primary service port can be configured during the Port Configuration step.
After deployment, the Primary service port can only be adjusted using the procedure in this article.
Solution
Changing the Port on the Veeam Backup Server
The following steps are performed on the Veeam Backup Server.
- Open an Administrative PowerShell Terminal session on the Veeam Backup Server.
- Stop the Veeam Reverse Proxy Service:
- Open the following file in a text editor:
C:\ProgramData\Veeam\ReverseProxy\Config\appsettings.json - Within the
Servicesection, change the value ofPortto the new port number.
After the change, theServicesection will appear as follows:"Service": { "Port": 8443, "TlsHandshakeTimeout": "00:00:30" } - Save the file.
- In Windows Firewall, create an inbound rule that allows TCP traffic on the new port. The rule created by the installer allows traffic on the original port only, and is not updated automatically. Operations that require this port, such as file-level restores through a remote mount server, fail while the port is closed. The rule can be created using the following PowerShell command:
- Restart the Veeam Backup Server so that every Veeam service starts with the new port. Restarting only the Veeam Reverse Proxy Service, or only the Veeam Backup Service, is not sufficient, because all Veeam services must use the new port.
Updating Remote Consoles
Machines running a remote Veeam Backup & Replication Console, or connecting to the Veeam Backup Server with PowerShell, read the port to connect with from the ReverseProxyCustomPort registry value. If the value is not set, connections continue to be attempted on the default port 443 and will fail.
Note: The ReverseProxyCustomPort value determines only which port a client connects to. It does not change the port that the Veeam Reverse Proxy Service listens on. Setting this value without also changing the port used by the Veeam Reverse Proxy Service on the Veeam Backup Server will cause connections to fail. On the Veeam Backup Server itself, the value is ignored because the local appsettings.json file always takes precedence.
On each machine running a remote Veeam Backup & Replication Console or connecting with PowerShell, create or modify the following registry value:
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication\
Value Name: ReverseProxyCustomPort
Value Type: DWORD (32-Bit) Value
Value Data: 8443
After the value has been set, restart the Veeam Backup & Replication Console.
The registry value can also be created using the following PowerShell command:
Non-Elevated Consoles
A console that is started without elevation cannot read the port from either the local appsettings.json file or the ReverseProxyCustomPort value under HKEY_LOCAL_MACHINE, and continues to connect to port 443. For users who run the console without elevation, use one of the following:
- Run the Veeam Backup & Replication Console as an administrator.
- Specify the port explicitly when connecting, in the
host:portformat. - Create the
ReverseProxyCustomPortvalue underHKEY_CURRENT_USER\SOFTWARE\Veeam\Veeam Backup and Replication\instead of theHKEY_LOCAL_MACHINElocation.
Verification
After the Veeam Backup Server has restarted, run the following command on the Veeam Backup Server to confirm that the Veeam Reverse Proxy Service is listening on the new port:
The change can also be confirmed in the following log:
C:\ProgramData\Veeam\ReverseProxy\Logs\service.log
After the restart, the listeners are bound to the new port:
[INF] Now listening on: https://localhost:8443 [INF] Now listening on: https://[::]:8443
Known Issue: Veeam Backup Enterprise Manager Loses Its Connection to the Backup Server
Issue Summary
After the port is changed, Veeam Backup Enterprise Manager continues to connect to the Veeam Backup Server on the previous port. The port cannot be updated by editing the backup server in the Enterprise Manager web UI. The failed connection is recorded in the Svc.VeeamBES.log file, as shown in the following example:
[CGrpcVbSrvServiceProxy] Connecting by certificate to VBR's [vbr.domain.tld] grpc port [443]. New remoting client id generated: Updating licensed instances group ids Unable to connect by gRPC to host [vbr.domain.tld] No connection could be made because the target machine actively refused it.
Resolution
To restore the connection:
- Remove the backup server from Enterprise Manager.
- Add it again, specifying the new port.
Note: Re-adding a backup server can create duplicate entries in the Enterprise Manager database. The duplicate entries are temporary.
This behavior will be improved in a future version to allow the port used to connect to the Veeam Backup Server to be modified.
Known Issue: Veeam Updater Connection Errors
Issue Summary
When the Primary service port has been changed, host discovery (a rescan of the Veeam Backup Server) and Update Settings Synchronization continue to connect to the Veeam Updater service on port 443. As a result, the following error occurs:
Failed to connect to the Veeam Updater service No connection could be made because the target machine actively refused it. (hostname:443)
While this error occurs, the Veeam Updater service may be unable to retrieve licensing information and discover available updates.
Resolution
This issue was resolved starting in Veeam Backup & Replication 13.1.2.
Known Issue: Veeam Service Provider Console Cannot Connect to the Backup Server
Issue Summary
In Veeam Service Provider Console 9.2 and older, connections to a Veeam Backup Server are always made using port 443. When the Primary service port has been changed, the following operations fail:
- Adding the backup server as a Cloud Connect server or as a hosted backup server fails with the error
Backup services are not responding or not running, although all Veeam services are running. - Opening a wizard that is redirected from Veeam Service Provider Console for a managed backup server fails with the error
Failed to load the backup server plugin. Refresh the page and try again. - Opening the backup server web UI using Open Web UI fails with the error
Target product's (Vbr) UI is inaccessible.
Resolution
This issue was resolved starting in Veeam Service Provider Console 9.3, now the configured port will be used appropriately.
More Information
If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.