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
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

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

Impact on Connected Components
Changing the primary service port affects components that connect to the Veeam Backup Server. Connections from remote Veeam Backup & Replication Consoles and PowerShell are covered in this article. Other components that connect to the Veeam Backup Server may also be affected, including the known issues described at the end of this procedure. The Veeam Backup Server must be restarted so that every Veeam service uses the new port, and each remote console machine must be updated separately. This procedure should be performed during a maintenance window to reduce the impact on data protection operations.
In the steps below, port 8443 is used as the new port for example only.

Changing the Port on the Veeam Backup Server

The following steps are performed on the Veeam Backup Server.

  1. Open an Administrative PowerShell Terminal session on the Veeam Backup Server.
  2. Stop the Veeam Reverse Proxy Service:
Stop-Service VeeamReverseProxySvc
  1. Open the following file in a text editor:
    C:\ProgramData\Veeam\ReverseProxy\Config\appsettings.json
  2. Within the Service section, change the value of Port to the new port number.
    After the change, the Service section will appear as follows:
    "Service": {
      "Port": 8443,
      "TlsHandshakeTimeout": "00:00:30"
    }
    
  3. Save the file.
  4. 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:
$port = 8443
New-NetFirewallRule -DisplayName "Veeam Reverse Proxy Service (Custom Port) (In)" -Direction Inbound -Protocol TCP -LocalPort $port -Action Allow
  1. 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:

$port = 8443
New-ItemProperty -Path "HKLM:\SOFTWARE\Veeam\Veeam Backup and Replication" -Name "ReverseProxyCustomPort" -Value $port -PropertyType DWORD -Force

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:port format.
  • Create the ReverseProxyCustomPort value under HKEY_CURRENT_USER\SOFTWARE\Veeam\Veeam Backup and Replication\ instead of the HKEY_LOCAL_MACHINE location.

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:

netstat -ano | findstr ":8443"

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:

  1. Remove the backup server from Enterprise Manager.
  2. 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.

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.

Spelling error in text

Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.