This is an archive version of the document. To get the most up-to-date information, see the current version.

Connecting to Veeam Backup Server

To create Veeam Agent backups on a backup repository managed by Veeam Backup & Replication, you must connect to a Veeam backup server.

Connecting to Veeam Backup Server Important!

Currently, Veeam Agent for Linux can be connected to one Veeam Backup & Replication server only. If you want to create backups on the backup repository managed by another Veeam backup server, you need to delete currently used backup server and all jobs targeted at backup repositories managed by this backup server. To learn more, see Deleting Connection to Veeam Backup Server.

If you add a connection to another backup server, backup jobs targeted at the original backup server will fail, and backups created on the Veeam backup repository will become unavailable in Veeam Agent for Linux. To continue using the original backup server, you need to delete the connection to the new backup server and recreate all backup jobs that use the original backup server.

If you change an account to connect to the Veeam backup server and then start a backup job targeted at the backup repository managed by this backup server, Veeam Agent for Linux will start a new backup chain on the backup repository.

To connect Veeam Agent for Linux to a Veeam backup server, use the following command:

veeamconfig vbrserver add --name <vbr_name> --address <vbr_address> --port <vbr_port> --login <username> --domain <domain> --password <password>

where:

<vbr_name> — name of the Veeam backup server that manages the backup repository.
<vbr_address> — IP address of the Veeam backup server.
<vbr_port> — port over which Veeam Agent for Linux must communicate with Veeam Backup & Replication. The default port used for communication with the Veeam backup server is 10006.
<username> — a user name of the account that has access to the Veeam backup repository.
<domain> — a name of the domain in which the account that has access to the Veeam backup repository is registered.
<password> — password of the account that has access to the Veeam backup repository.

Permissions on the backup repository managed by the target Veeam backup server must be granted beforehand. To learn more, see Setting Up User Permissions on Backup Repositories.

For example:

user@srv01:~$ veeamconfig vbrserver add --name vbr01 --address 172.17.53.1 --port 10002 --login veeam --domain tech --password P@ssw0rd

When Veeam Agent for Linux connects to a Veeam Backup & Replication server, Veeam Agent for Linux retrieves information about backup repositories managed by this Veeam backup server and displays them in the list of available backup repositories. You can then specify a Veeam backup repository as a target for a backup job.

Connecting to Veeam Backup Server Tip:

To view the list of backup repositories, use the veeamconfig repository list command. To learn more, see Viewing List of Backup Repositories.