TRY NOW
book meeting
BACK TO KB LIST

How to Set Custom Deployer and Data Mover Ports for Managed Linux Agents

KB ID: 4519
Product: Veeam Backup & Replication | 12.1 | 12.2 | 12.3 | 12.3.1 | 12.3.2 | 13 | 13.1
Veeam Agent for Linux | 6.1 | 6.2 | 6.3 | 6.3.1 | 6.3.2 | 13 | 13.1
Published: 2023-12-05
Last Modified: 2026-01-14
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

By default, during the deployment of Veeam Agent for Linux on a Linux machine by Veeam Backup & Replication, the services listed below use the default ports indicated. This article documents how to change those default ports using custom settings on the Veeam Backup Server. 

  • Veeam Deployer Service (veeamdeployment) - Default Port: 6160
  • Veeam Transport Service (veeamtransport) - Default Port: 6162

Solution

Before You Begin

  • The custom port will only be assigned to Veeam Agent for Linux deployments that occur after the creation of the registry value.
  • There is no failover to the default port if communication fails using the custom port; ensure firewalls are configured accordingly.
  • To get the ID# of a Protection Group, use one of the following PowerShell commands:
  • To get a list of all Protection Groups and their IDs:
Get-VBRProtectionGroup | ft Name,Description,ID
  • To get the ID for a specific Protection Group by name:
Get-VBRProtectionGroup -Name 'Protection Group'
Port Assignment Logic

When a Protection Group begins the process of deploying Veeam Agent for Linux on a Linux machine, it uses the following logic priority to determine which ports should be used by the Deployment Service and Transport Service on that machine:

  • Use the custom port specified in the Protection Group-specific registry value if the Protection Group's ID is listed in that registry value.
  • Use the custom global port if one is configured in the registry.
  • Use the default port.

Veeam Deployer Service (veeamdeployment)

These settings change which port the Veeam Deployer Service binds to.

 

Protection Group-Specific Custom Deployer Service Port

Configuring this registry value will cause all new Veeam Agent for Linux deployments for the specified Protection Group(s) (specified by ID#)  to use the assigned port.

For Windows-based Veeam Backup & Replication Deployment

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMProtectionGroupCustomDeployerPort
Value Type: Multi-String Value [REG_MULTI_SZ]
Value Data: PG_ID:port

Each line should have PG_ID:port format. For example:

5b065724-eca0-4145-ba18-febcd4767ba1:6164
5d7604ff-92f9-41ee-9f8b-cc9359f0217f:7174
For Veeam Software Appliance (Veeam Backup & Replication on Linux)

Add the value to the configuration settings:

Configuration file: /etc/veeam/veeam_backup_and_replication.conf
Section: [root]
Setting: AMProtectionGroupCustomDeployerPort=PG_ID:port|PG_ID:port

Example:

AMProtectionGroupCustomDeployerPort=5b065724-eca0-4145-ba18-febcd4767ba1:6164|5d7604ff-92f9-41ee-9f8b-cc9359f0217f:7174

For more information on applying custom settings on the Veeam Storage Appliance, please review:
KB4779: Applying Custom Settings to Veeam Software Appliance

Global (All Protection Groups) Custom Deployer Service Port

Configuring this registry value will cause all new Veeam Agent for Linux deployments managed by Veeam Backup & Replication to use the assigned port.

For Windows-based Veeam Backup & Replication Deployment
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMCustomLinuxDeployerPort
Value Type: DWORD (32-Bit) Value [REG_DWORD]
Value Data: <port_number>
For Veeam Software Appliance (Veeam Backup & Replication on Linux)

Add the value to the configuration settings:

Configuration file: /etc/veeam/veeam_backup_and_replication.conf
Section: [root]
Setting: AMCustomLinuxDeployerPort=<port_number>

For more information on applying custom settings on the Veeam Storage Appliance, please review:

KB4779: Applying Custom Settings to Veeam Software Appliance

Pre-installed Veeam Deployer Service

Please note that the custom Veeam Deployment Service port configured via the registry will not impact scenarios involving the deployment of Veeam Agent for Linux using the pre-installed Veeam Deployer Service. To configure a custom port for the pre-installed Veeam Deployer Service, the following command must be executed after the standard set of pre-installed deployer commands has been completed, and the service must then be restarted:

/opt/veeam/deployment/veeamdeploymentsvc --set-port XXXX

Veeam Transport Service (veeamtransport)

These settings change which port the Veeam Transport Service binds to.
 

Protection Group-Specific Custom Transport Service Port

Configuring this registry value will cause all new Veeam Agent for Linux deployments for the specified Protection Group(s) (specified by ID#)  to use the assigned port for the Veeam Transport Service.

For Windows-based Veeam Backup & Replication Deployment

Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMProtectionGroupCustomDataMoverPort
Value Type: Multi-String Value [REG_MULTI_SZ]
Value Data: PG_ID:port

Each line should have PG_ID:port format. For example:

5b065724-eca0-4145-ba18-febcd4767ba1:6164
5d7604ff-92f9-41ee-9f8b-cc9359f0217f:7174
For Veeam Software Appliance (Veeam Backup & Replication on Linux)

Add the value to the configuration settings:

Configuration file: /etc/veeam/veeam_backup_and_replication.conf
Section: [root]
Setting: AMProtectionGroupCustomDataMoverPort=PG_ID:port|PG_ID:port

Example:

AMProtectionGroupCustomDataMoverPort=5b065724-eca0-4145-ba18-febcd4767ba1:6164|5d7604ff-92f9-41ee-9f8b-cc9359f0217f:7174

For more information on applying custom settings on the Veeam Storage Appliance, please review:
KB4779: Applying Custom Settings to Veeam Software Appliance

Global (All Protection Groups) Custom Transport Service Port

Configuring this registry value will cause all new Veeam Agent for Linux deployments managed by Veeam Backup & Replication to use the assigned port the Veeam Transport Service.

For Windows-based Veeam Backup & Replication Deployment
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication
Value Name: AMCustomDataMoverPort
Value Type: DWORD (32-Bit) Value [REG_DWORD]
Value Data: <port_number>
For Veeam Software Appliance (Veeam Backup & Replication on Linux)

Add the value to the configuration settings:

Configuration file: /etc/veeam/veeam_backup_and_replication.conf
Section: [root]
Setting: AMCustomDataMoverPort=<port_number>

For more information on applying custom settings on the Veeam Storage Appliance, please review:

KB4779: Applying Custom Settings to Veeam Software Appliance

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
Start using Veeam:
Download the product
&
Activate the license key
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.