Skip to main content

Install and Configure the Veeam Agent for Linux

Installation

ℹ️ In order to perform the installation and configuration process, you will need to be able to connect to the system over SSH and log in as a user with superuser privileges (or root).

The Veeam agent can be downloaded from a repository specific to your server's OS. On Linux, your distribution likely includes a file such as /etc/os-release that can be viewed to determine what repository to configure. Once you have determined your Linux distribution, select the tab below that corresponds to your OS. Each tab contains the commands that should be run for your distribution.

RHEL/CentOS/Fedora

Configure Repository​

  • RHEL/CentOS

    • RHEL/CentOS 8.x

      # yum install http://repository.veeam.com/backup/linux/agent/rpm/el/8/x86_64/veeam-release-el8-1.0.7-1.x86_64.rpm

    • RHEL/CentOS 7.x

      # yum install http://repository.veeam.com/backup/linux/agent/rpm/el/7/x86_64/veeam-release-el7-1.0.7-1.x86_64.rpm

    • RHEL/CentOS 6.x

      # yum install http://repository.veeam.com/backup/linux/agent/rpm/el/6/x86_64/veeam-release-el6-1.0.7-1.x86_64.rpm

  • Fedora

    • Fedora 30, 31, 32

      # yum install http://repository.veeam.com/backup/linux/agent/rpm/fc/24/x86_64/veeam-release-fc24-1.0.7-1.x86_64.rpm

    ✅ Note that the installation links above include specific version numbers in the RPM package names. The version number will change over time, so if you try the appropriate command listed above and you are told the package cannot be found, try checking the repository (http://repository.veeam.com/backup/linux/agent/rpm/el/7/x86_64/ for example) and see what the latest available version number is and adjust the installation command with the URL to the latest version of the veeam-release package.

Install Dependencies​

  1. If you are on a RHEL/CentOS system, then you may not have access to certain required dependencies such as the dkms package. If this is the case, you may need to configure access to another repository such as EPEL which provides access to this package. The below command will install the EPEL repository.

    # yum install epel-release

  2. Although not a requirement, it is recommended to install the genisoimage package as this is necessary in order to create an optional recovery image file later.

    # yum install genisoimage

Install Agent​

With access to the Veeam repository and the necessary dependencies, you can now run the below command to install the Veeam agent.

# yum install veeam
Debian/Ubuntu

Configure Repository​

# wget https://repository.veeam.com/backup/linux/agent/dpkg/debian/public/pool/veeam/v/veeam-release-deb/veeam-release-deb_1.0.9_amd64.deb

# apt-get install veeam-release-deb_1.0.9_amd64.deb

✅ Note that the installation link above includes a specific version number in the DPKG package name. The version number will change over time, so if you try the  command listed above and you are told the package cannot be found, try checking the repository (https://repository.veeam.com/backup/linux/agent/dpkg/debian/public/pool/veeam/v/veeam-release-deb/ for example) and see what the latest available version number is and adjust the installation command with the URL to the latest version of the veeam-release-deb package.

Install Agent​

# apt-get install veeam

Configuration

A Veeam recovery media ISO is necessary in order to restore a volume level backup.

Now that you have configured and installed the Veeam agent, you can proceed with performing basic configuration and licensing it.

  1. Run veeamconfig ui to access the configuration tool for the Veeam agent. The selected option in this interface can be changed using the Arrow and Tab Keys, and options can be toggled with the Space key.

    # veeamconfig ui

  2. Once you have completed the Agreements page, you should be on the Recovery ISO page. While optional, it is highly recommended to create the custom Veeam Recovery Media ISO on this step. In the event of your server failing to boot, the recovery image can be used to boot into a limited Linux system that can then be used to restore your data.

  3. Once on the License page, you will want to point the File Location field to the path of your Veeam license. If the license is not configured, the Veeam agent will run in free mode which will not be able to take backups to a Cloud Connect repository.