Creating Repository in SMB Share

To create a repository in an SMB share, you must specify a name for the repository, a path to the network shared folder in which Veeam Agent will create backup files, a type of the network shared folder and additional mounting options. To do this, use the following command:

veeamconfig repository create --name <repository_name> --type smb --location <path_to_repository>  
--username <user_name> --password --domain <domain>

where:

  • <repository_name> — name for the backup repository.
  • <path_to_repository> — path to the network shared folder where backup files will be stored in the //SERVER/FOLDER format.

Creating Repository in SMB Share Important

If the directory to which the shared folder should be mounted resides on the backed-up volume, the backup job may fail.

  • <user_name> — account name that Veeam Agent will use to access the SMB network shared folder.
  • <domain> — domain in which the account that has access permissions on the shared folder is registered.

Mind that if you specify --password parameter, Veeam Agent will prompt you to specify a password for the SMB network shared folder.

Examples

Command with --username, --password, --domain parameters:

$ veeamconfig repository create --name VeeamBackup --type smb --location //srv02/VeeamRepository --username Administrator --password --domain srv02

Creating Repository in SMB Share TIP

  • If you mount a network shared folder to a folder in the Veeam Agent machine file system in advance, you can create the backup repository in the same way as in a local folder. For details, see Creating Repository in Local Folder.
  • macOS may save CIFS/SMB credentials in a cache. As a result, if credentials have been changed, Veeam Agent for Mac uses obsolete credentials and fails to connect to shared folders. To refresh cached credentials, reboot the Veeam Agent computer.

Page updated 1/23/2024

Page content applies to build 2.2.0.81