Advanced Settings

Advanced options for SFTP Drive are stored in the Windows registry in HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\SFTPDrive\2. This registry key holds settings that are available for SFTP Drive globally. Sub-keys at this path hold settings for individual drives, and trusted SSH host keys.

The following keys hold configuration information:

Registry KeyApplicable Settings
HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\SFTPDrive\2Global settings for the application.
HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\SFTPDrive\2\DrivesDrives hold drive specific settings.
HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\SFTPDrive\2\TrustedSSHHostKeysTrusted SSH Host Keys stores trusted host keys.

The following values can be configured within the root HKEY_LOCAL_MACHINE\SOFTWARE\nsoftware\SFTPDrive\2 registry key:

NameTypeDescription
DeleteLogDaysDWORDSpecifies the number of days that log files will remain before being deleted. Only applies if RotateLogDays is greater than 0. If set to 0, old logs will not be deleted.
LogFileStringContains the path to the log file.
LogModeDWORDDetermines the level of logging:
  • 0 - Off. Nothing will be logged.
  • 1 - Error. Only errors in SFTP Drive's operation will be logged.
  • 2 - Warning. Additional warning information will be logged.
  • 3 - Info. General information about the status of the connection will be logged.
  • 4 - Verbose. Logs additional information about the connection and detailed protocol information.
  • 5 - Debug. Logs detailed debug information.
LogPortDWORDThe SysLog port that will be used to communicate between the service and the UI when SFTP Drive is running as a service.
LogToFileDWORDDetermines whether or not the log will be written to a file. The file itself is specified by LogFile.
  • 0 - The log will only be written to the Log window on the Service tab. (default)
  • 1 - The log will also be saved to a file.
MaskSensitiveDWORDDetermines whether or not passwords will be masked in the log.
  • 0 - Passwords will be visible in the log.
  • 1 - Passwords will be replaced with '*' characters in the log. (default)
MaxLogLinesDWORDDetermines the maximum number of lines that will be stored in the Log window in the Service tab.
MountTimeoutDWORDDetermines how long (in seconds) SFTP Drive will wait for Windows to mount a drive without reporting an error. The default is 20 seconds when this value is not present in the registry.
PasswordEncryptionMethodStringDetermines how passwords are encrypted for storage. The default value is Auto. Possible values are:
  • Auto (default) - Microsoft DPAPI is used to encrypt passwords. When running the application as a user (not as a Windows service) the passwords are encrypted and can only be decrypted by the current user.

    When running as a Windows service the passwords are encrypted for the machine and can be decrypted by any user on the machine. When running as a Windows service the user application and the service run under different accounts and must both be able to decrypt the values stored in the registry.

Additional values are reserved for future use.
PromptForRegPermissionsDWORDDetermines if SFTP Drive will ask for registry permissions if it does not have them when it tries to write to the registry.
  • 0 - SFTP Drive will not ask for registry permissions, instead bringing up a UAC dialog for one-time access.
  • 1 - SFTP Drive will ask to be granted registry permissions. If granted, UAC access will not be required in the future. (default)
RotateLogDaysDWORDSpecifies how many days SFTP Drive will use a log file before rotating to a new log file. If set to 0, the log file will never rotate.
RunAsServiceDWORDDetermines whether or not SFTP Drive will run as a service.
ShowDotFilesDWORDDetermines whether files that start with a dot or period (.) are returned in a directory listing.
  • 0 - Dot files are not returned, so they are not displayed in explorer.
  • 1 - Dot files are returned in the directory listing (default).
HideDotFilesDWORDDetermines whether files that start with a dot or period (.) are marked as hidden when returned in a directory listing.
  • 0 - Do not hide dot files (default).
  • 1 - Any dot files will be marked with the hidden attribute.
UseCacheDWORDSpecifies whether or not SFTP Drive will use caching for file metadata and contents. Disabling will slow performance, and will cause SFTP Drive to re-download a file every time it is requested by Windows.
  • 0 - No cache
  • 1 - Use caching (default)
KeepAliveIntervalDWORDDetermines how often a keep alive packet is sent to the server, in seconds. If set to 0, no keep alive packets will be sent.
LocalHostStringSpecifies the local IP address of the network interface to use when connecting. This settings is typically only useful in machines with multiple network interfaces.
LogPacketsDWORDDetermines whether or not the contents of SFTP Packets will be written to the log. Note that the additional output from this mode will slow operation considerably, so it is recommended that it only be enabled when necessary to diagnose an issue.
  • 0 - SFTP packet contents will not be logged (default)
  • 1 - SFTP packet contents will be written to the log.
ProxyCheckedDWORDSpecifies whether or not the proxy settings are enabled.
ProxyHostStringSpecifies the host that SFTP Drive will use to connect to the proxy.
ProxyPasswordStringSpecifies the password that SFTP Drive will use to connect to the proxy.
ProxyPortDWORDSpecifies the port that SFTP Drive will use to connect to the proxy.
ProxyTypeDWORDSpecifies the type of proxy that SFTP Drive will connect to.
  • 0 - None (default)
  • 1 - Tunnel
  • 2 - SOCKS4
  • 3 - SOCKS5
ProxyUsernameStringSpecifies the username that SFTP Drive will use to connect to the proxy.
ReconnectAttemptsDWORDSpecifies the number of times SFTP Drive will attempt to reconnect if the connection to the server is lost.
ReconnectIntervalDWORDSpecifies the time (in seconds) between attempting another reconnection to the server. Default is 5 seconds.
TimeoutDWORDDetermines how many seconds SFTP Drive will wait for a response from the server before ending the connection.
UseCompressionDWORDDetermines whether or not the SSH connection will use zlib compression.
  • 0 - No compression (default)
  • 1 - Use zlib compression

 
 
Copyright (c) 2021 /n software inc. - All rights reserved.
SFTP Drive V2 - Version 2.0 [Build 7722]