Connecting to Veeam Backup Server

In this article

    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. To continue using the original backup server, you need to delete the connection to the new backup server and re-create 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 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> — DNS name or IP address of the Veeam backup server.

    Connecting to Veeam Backup Server IMPORTANT

    If you specify a DNS name of the Veeam backup server, make sure that the Veeam backup server name is resolved into IPv4 address on the machine where Veeam Agent is installed. The Veeam Backup Service in Veeam Backup & Replication listens on IPv4 addresses only. If the Veeam backup server name is resolved into IPv6 address, Veeam Agent will fail to connect to the Veeam backup server.

    • <vbr_port> — port over which Veeam Agent must communicate with Veeam Backup & Replication. The default port used for communication with the Veeam backup server is 10006.
    • <username> — a 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 10006 --login veeam --domain tech --password P@ssw0rd

    When Veeam Agent for Linux connects to a Veeam Backup & Replication server, Veeam Agent 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.

     

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.