How do I use Veeam Standalone Agent for Linux (v6) with Wasabi?

Wasabi is a member of Veeam's cloud partner ecosystem. We have worked with Veeam closely to offer both a seamless implementation, and a smooth transition to cloud storage. Veeam with Wasabi Solution Overview provides more information on the Wasabi-Veeam partnership and solutions

Wasabi has been validated to work with Veeam Agent for Linux (6) in standalone mode to protect data on Linux computers and backup directly to Wasabi's Object storage. Veeam Agent for Linux version 6 introduces support for Backup directly to cloud object storage as well as support for immutable backups.

Note: The data restoration process is handled by your specific backup software application. As there are many potential variables that will affect your unique environment, it is strongly recommended that you seek the guidance of your backup software's technical support team in the event that you encounter difficulty, or have application-specific inquiries.


Table of Contents

  1. Prerequisites 
  2. Architecture Diagram
  3. Create a Backup Job
  4. Manually Run the Backup Job
  5. Restore a Backup
  6. Enabling Immutability


1. Prerequisites

  • Active Wasabi Storage account
  • Veeam Agent for Linux version 6 installed and licensed. 
  • A valid Veeam license that supports capabilities for object storage.

2. Architecture Diagram


3. Create a Backup Job

Veeam Backup agent for Linux has a GUI-like user interface called "Control Panel" that lets users perform main backup and restore tasks in an easy way. These tasks and some more advanced operations can be done using the command line interface also. Please refer to Veeam Agent for Linux documentation for the command line interface with Veeam Agent for Linux control panel, you do not need to work with Linux shell and remember numerous commands. 

The control panel can be navigated using the below keys:

  • Tab — to switch between controls and buttons in the Backup Job wizard.
  • Up and Down — to switch between items in a scrollable list.
  • Space — to select the necessary item in a list. The selected item's mark may vary in different steps of the wizard.
  • Enter — to proceed to the next step of a wizard or to view details of the backup job session selected in the list of sessions.
  • Backspace — to return to the previous step of a wizard (you cannot use this button to change wizard steps when a text field is selected).
  • Esc — to exit the currently used wizard or close the Veeam Agent for Linux control panel.

3.1 Open Veeam Agent for Linux by typing "Veeam" in terminal. Press "C"


3.2 Input the name for the backup job and press the Return key.


3.3 Select the backup mode you want and press the Return key. This example shows Entire machine but Volume and File level backs can also be taken. Refer to Veeam Agent for linux documentation for Backup mode for more details.


3.4 On the Destination page, select "Object storage" and press the Return key.


3.5 On the Object Storage page, select "S3 Compatible" and press the Return key.


3.6 Input the Wasabi account details and press the return key-

Note: In this example we are using us-east-1 region. To get a list of Wasabi regions, refer to service URLs for Wasabi's different storage regions.


3.7 Press Return on "Browse" to choose the Wasabi bucket to be used. Press return on "Browse" under Folder to to choose an existing folder in the bucket or create a new folder. Press on "Next" to continue.


3.8 On the Schedule page, optionally check "Run the job automatically" and configure the schedule settings. Press the Return key to continue.


3.9 Review the summary and check "Run the job when I click Finish" to run the backup job immediately. Press the Return key to finish creating the backup job.


3.10 The Backup job is created and starts running. Press the return key on the Info box.



4. Manually Run the Backup Job

4.1 Open Veeam Agent for Linux and press "S" to start a backup job.


4.2 Select the backup job to run and press the Return key to run the job or press "F" to run a full backup for the selected job.


4.3 The backup job is running and control panel shows you the status of the job.


4.4 You can view the stats of a backup job by selecting the backup from the control panel and pressing the return key to show the stats.



5. Restore a Backup

5.1 Restoring Volumes using CLI

You can restore a specific computer volume or all volumes from a volume-level backup using the command line interface (CLI). This feature is not available on control panel of Veeam Agent for Linux. When you restore a volume from the backup, Veeam Agent will automatically select the latest restore point in the backup. You can also select a specific restore point in the backup to recover data to a desired point in time. Use the commands below to perform a volume level restore. For more details refer to the Veeam Help Center article for restoring from backup.

Note: If a volume is restored to the original location, Veeam will overwrite the files in that location.

5.1.1 Locate the backup.

To view a list of backups created by Veeam Agent, use the below command-

veeamconfig backup list --all

5.1.2 Explore the backup content.

View the detailed information about specific backup using the below command-

veeamconfig backup show --id <backup_id>

where <backup_id> — ID of the backup for which you want to view detailed information.

5.1.3 To view information about restore points in the backup, use the following command-

veeamconfig point list --backupid <backup_id>

<backup_id> — ID of the backup for which you want to view information on restore points

5.1.4 Start the restore process.

To start the volume-level restore from a backup, use the following command-

veeamconfig backup restore --id <backup_id> --targetdev <target_volume> --backupdev <volume_in_backup>

To start the volume-level restore from a specific restore point, use the following command:

veeamconfig point restore --id <point_id> --targetdev <target_volume> --backupdev <volume_in_backup
  • <backup_id> — ID of the backup.
  • <point_id> — ID of the restore point.
  • <target_volume> — path to a block device that represents a volume on your computer that you want to recover. This parameter is optional.
  • <volume_in_backup> — path to a block device that represents a volume in the backup.

5.1.5 Monitor the restore process.

To view Veeam Agent for Linux session log, use the following command-

veeamconfig session log --id <session_id>

<session_id> — ID of the restore session


5.2 Restoring Files and Folders using the Recovery Wizard.

File level restore can be performed using the Veeam control panel recovery wizard. Follow the steps below to run the recovery wizard for restoring files and folders-

5.2.1 Launch the Veeam Agent control panel with the "veeam" or "veeamconfig ui" command. Press the "r" key to proceed to the File Level Restore wizard.


5.2.2 Select the Backup you want to restore from and press the return key.


5.2.3 Select the restore point to use and press the enter key.


5.2.4 The Veeam agent mounts the backup files to "/mnt/backup" directory. Press return key on "OK" to continue.


After the backup files are mounted to the /mnt/backup directory on the computer's file system, you can use Linux command line utilities or the preferred file browser to browse the files and directories in the mounted backup and copy the files and directories that you want to restore to their initial location or to a new location.


6. Enabling Immutability

In version 6 of Veeam Agent for Linux, Veeam introduced immutability support for backup jobs. When you store your backup data in Wasabi, Veeam Agent allows you to protect backup data from deletion or modification by making that data temporarily immutable using the Object lock feature on Wasabi bucket.

This section details the procedure to create immutable backups using a backup job for your linux computer. 

6.1 Create an Object Lock enabled bucket.

Follow the Wasabi guide to creating an Object Lock enabled bucket.

Note: Do not enable "Bucket-Level Object Retention" settings on the "Object Lock" tab for your bucket. The screenshot below illustrates the correct way to have Object Lock configured.

6.2 Enable immutability while creating the backup job. Follow the steps in Section 3 of this article to create a backup job. In step 3.7 on the Bucket page, once you browse the bucket and create a new folder, enable immutability by checking the "Make backups immutable" box and then specify the number of days to keep the backup immutable. Once you press return on "Next", you will get a confirmation box regarding increase in costs due to immutability. Press "OK" to continue.


6.3 Complete the remaining steps to create the backup job. Once a successful backup is written to Wasabi, you can confirm immutability is enabled by viewing file properties on Wasabi console. 

Note: To view object lock properties of files on Wasabi console, check the checkbox beside "Show versions" on Wasabi console.

Screenshot 2024-01-16 at 5.27.07 AM.png



Have more questions? Submit a request