Skip to main content

dvs storage add

Add a new storage remote configuration.

Syntax​

dvs storage add [name] [options]

Options​

OptionDescription
--type <transport>Transport type: ssh, sftp, ftp, s3, gdrive, local

Interactive Mode​

Without arguments, starts interactive configuration:

dvs storage add

Prompts for:

  1. Storage name
  2. Transport type
  3. Transport-specific parameters (host, path, credentials...)

CLI Mode​

# Add with transport type
dvs storage add mybackup --type sftp

# Then configure parameters
dvs storage set mybackup.default.host backup.example.com
dvs storage set mybackup.default.path /backups
dvs storage set mybackup.default.user admin

Transport Parameters​

SSH / SFTP​

ParameterRequiredDescription
hostYesServer hostname or IP
portNoPort (default: 22)
userYesSSH username
pathYesRemote base path
keyNoPath to private key

S3​

ParameterRequiredDescription
endpointYesS3 endpoint URL
bucketYesBucket name
access_keyYesAccess key ID
secret_keyYesSecret access key
regionNoAWS region

FTP​

ParameterRequiredDescription
hostYesFTP server
portNoPort (default: 21)
userYesFTP username
passwordYesFTP password
pathYesRemote path
tlsNoEnable FTPS (true/false)

Google Drive (gdrive)​

Authentication uses OAuth 2.0. When adding a storage with --type gdrive, an interactive flow opens in the browser to authorize access to your Google Drive. The token is stored locally in DVS secrets; no manual parameters are required.

dvs storage add mygdrive --type gdrive

Requires DVS to be run with the OAuth redirect URL configured (e.g. via dvsctl or equivalent). Only one admin instance should expose the OAuth callback for the flow to complete correctly.

Local​

ParameterRequiredDescription
pathYesLocal directory path