Config

Full Config

name

string - A string to identify your config.

context

string - A path relative to the workspace root folder.

Default

workspace root

protocol

string - sftp or ftp.

Default

sftp

host

string - Hostname or IP address of the server.

Default

sftp

port

integer - Port number of the server.

Default

22

username

string - Username for authentication.

password

string - Password for password-based user authentication.

remotePath

string - The absolute path on remote

Default

/

uploadOnSave

boolean - Upload on every save operation of VS code

Default

false

downloadOnOpen

boolean - Download the file from the remote server whenever it is opened

Default

false

syncMode

string - Set to 'update' so 'sync command' will only affect those files exist in both local and server. Set to 'full', 'sync' will be same as 'download/upload' besides deleting file not exist in origin from target.

Default

update

ignore

string[] - Same behavior as gitignore, all path reltative to context of the current config

Default

[]

ignoreFile

string - Absolute path to the ignore file or Relative path relative to the workspace root folder.

watcher

object.

watcher.files

string - glob patterns that are watched and when edited outside of the VS cdoe editor are processed. Set uploadOnSave to false when you watch everything.

watcher.autoUpload

boolean - upload when file changed

watcher.autoDelete

boolean - delete when file removed

watcher.autoDelete

number - Lower concurrency could get more stability because some client/server have some sort of configured/hard coded limit.

Default

4

SFTP only Config

agent

string - Path to ssh-agent's UNIX socket for ssh-agent-based user authentication. Windows users: set to 'pageant' for authenticating with Pageant or (actual) path to a cygwin "UNIX socket".ld get more stability because some client/server have some sort of configured/hard coded limit.

privateKeyPath

string - Absolute path to user private key.

passphrase

mixed - For an encrypted private key, this is the passphrase string used to decrypt it. Set to true for enable passphrase dialog. This will prevent from using cleartext passphrase in this config.

interactiveAuth

boolean - Set to true for enable verifyCode dialog. Keyboard interaction authentication mechanism. For example using Google Authentication (Multi factor)

Note: (requires the server to have keyboard-interactive authentication enabled)

Default

false

algorithms

Explicit overrides for the default transport layer algorithms used for the connection.

Default

algorithms: {
  "kex": [
    "ecdh-sha2-nistp256",
    "ecdh-sha2-nistp384",
    "ecdh-sha2-nistp521",
    "diffie-hellman-group-exchange-sha256",
    "diffie-hellman-group14-sha1"
  ],
  "cipher": [
    "aes128-ctr",
    "aes192-ctr",
    "aes256-ctr",
    "aes128-gcm",
    "[email protected]",
    "aes256-gcm",
    "[email protected]"
  ],
  "serverHostKey": [
    "ssh-rsa",
    "ecdsa-sha2-nistp256",
    "ecdsa-sha2-nistp384",
    "ecdsa-sha2-nistp521"
  ],
  "hmac": [
    "hmac-sha2-256",
    "hmac-sha2-512",
    "hmac-sha1"
  ]
},

sshConfigPath

Absolute path to your SSH config file.

Default

~/.ssh/config

FTP only Config

secure

mixed - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990)

Default

false

secureOptions

Additional options to be passed to tls.connect(). see https://nodejs.org/api/tls.html#tls_tls_connect_options_callback