Deploying the Windows app via MSI

Posted on 4th December 2018

The Windows drive mapping client provides access to any storage presented through Foldr directly from Windows Explorer using a single mapped drive.

Windows – System Requirements

Windows 7 – 10 (32bit or 64bit)
Visual C++ 2015 runtime – 14.0.24215 is required or higher

Download Links

Foldr for Windows – 64 bit (self extracting EXE installer)

Foldr for Windows – 64 bit (zip with MSI)

Foldr for Windows – 32 bit (self extracting EXE installer)

Foldr for Windows – 32 bit (zip with MSI)

The pre-requisite Visual C++ runtime  is available here:

Visual C++ runtime for Windows 32 bit

Visual C++ runtime for Windows 64 bit

NOTE –  Currently the self extracting .exe will attempt to install the correct runtime version, even if a later runtime is already installed.  This will prevent the installation from completing successfully.  Any later version of the Visual C++ runtime will work with Foldr for Windows.  If a later runtime is already installed, you can use the MSI to install the Foldr application only.


Deploying Foldr for Windows

The Windows drive mapping client can be deployed to multiple computers using common software deployment tools.  These include Group Policy, SCCM, scripts or open source deployment tools such as WPKG. It is recommended that the MSI remains accessible to the client, whether over a local or network connection, if deployed centrally.

The administrator can optionally pass various options to the installer to configure the application as required.

Registry Settings

By using any of the following msiexec installer options, registry keys are created automatically for each under:

HKEY_LOCAL_MACHINE\SOFTWARE\Foldr\Default

These keys apply to all users of the system and as such an adminstrator can configure the Foldr app by pushing these registry values to workstations, instead of using the msiexec options.  This is typically done via Group Policy Preferences or via a script.

Example Installation Command

msiexec /i FoldrSetup.msi /quiet /log install.log FOLDR_SERVER=https://demo.foldr.io REQUIRES_ANTIVIRUS=1 DETECT_RENAME_THREAT=1 DETECT_EXTENSIONS_THREAT=1 FOLDR_DRIVE="R:" SHARES="1,3"

MSI Install Options

All options are disabled by default

Option Value Registry Key
FOLDR_SERVER eg. “my.foldr.server” FoldrServer
REQUIRES_ANTIVIRUS 1 or 0 RequiresAntivirus
AV_UPDATE_GRACE_MINUTES Any numeric value AVUpdateGraceMinutes
AV_GRACE_MINUTES Any numeric value AVGraceMinutes
DETECT_RENAME_THREAT 1 or 0 DetectRenameThreat
DETECT_EXTENSIONS_THREAT 1 or 0 DetectExtensionsThreat
FOLDR_DRIVE eg “Z:” FoldrDrive
DRIVE_TYPE_REMOVABLE 1 or 0 DriveTypeRemovable
USER_CAN_CHANGE_DRIVE_TYPE 1 or 0 UserCanChangeDriveType
USER_CAN_CHANGE_DRIVE_LETTER 1 or 0 UserCanChangeDriveLetter
SHARES eg: “1,2,10” EnabledShares
UPDATES_ENABLED 1 or 0 UpdatesEnabled
SIGN_OUT_ON_EXIT 1 or 0 SignOutOnExit
SSO_LOGIN_BY_DEFAULT 1 or 0 SSOLoginByDefault
SERVER_OS_USING_DRIVE eg “Z:” See details below
CACHE_EXPIRY_DAYS 1, 5, 7, 14 or 28 CacheExpiryDays
CERTIFICATE_PROMPTS 1 or 0 CertificatePrompts
UPLOAD_NOTIFICATIONS 1 or 0 UploadNotifications
SHOW_WINDOWS_SHORTCUTS 1 or 0 ShowWindowsShortcuts
OFFICE_AUTO_CHECKOUTS 1 or 0 OfficeAutoCheckouts
USE_MY_FILES 1 or 0 UseMyFiles
OPEN_DRIVE_AT_STARTUP 1 or 0 OpenDriveAtStartup
CLEAR_CACHE_ON_EXIT 1 or 0 ClearCacheOnExit
SSO_AUTO_SIGN_IN 1 or 0 SSOAutoSignIn

 

Option Details

FOLDR_SERVER=<SERVER ADDRESS>

Sets the default Foldr server address and will pre-populate the server address in the sign-in dialog.

Registry Setting
Name = FoldrServer
Type = REG_SZ (String)
Value = https://foldr.yourdomain.com

REQUIRES_ANTIVIRUS=1|0

Determines whether Antivirus is required to be enabled and up to date on the client machine.   If set to =0 during installation, users will be able to change this option under Settings > Advanced tab; NOTE that on the client this setting will enabled by default.

Note: This can be overridden by the Foldr appliance.

Registry Setting
Name = RequiresAntivirus
Type = REG_SZ (String)
Value = 1|0

AV_UPDATE_GRACE_MINUTES=1|0

When Foldr detects that the client’s antivirus is out-of-date, this option will allow the client machine the configured amount of time to update it’s AV definitions.  If the AV is not updated before the timer expires, the drive will be disconnected.

A value of 0 disables any grace period whatsoever, regardless of the value of AV_GRACE_MINUTES, below.

Note that the client itself must still be within AV_GRACE_MINUTES for this setting to apply.

Note: This can be controlled / overridden by the Foldr appliance within Foldr Settings >> Devices & Clients >> Windows

Registry Setting
Name = AVGraceMinutes
Type = REG_SZ (String)
Value = 1|0

AV_GRACE_MINUTES=1|0

The number of minutes allowed to elapse before an out-of-date Antivirus product causes the Foldr drive to go offline.

Note: This can be controlled / overridden by the Foldr appliance within Foldr Settings >> Devices & Clients >> Windows

Registry Setting
Name = AVGraceMinutes
Type = REG_SZ (String)
Value = 1|0

DETECT_RENAME_THREAT=1|0

Configures a value in the Windows Registry that determines whether we detect ransomware rename threats on the client machine.

Note: This can be overridden by the Foldr appliance.

Registry Setting
Name = DetectRenameThreat
Type = REG_SZ (String)
Value = 1 or 0

DETECT_EXTENSIONS_THREAT=1|0

Configures a value in the Windows Registry that determines whether we detect ransomware extension threats on the client machine.

Note: This can be overridden by the Foldr appliance.

Registry Setting
Name = DetectExtensionsThreat
Type = REG_SZ (String)
Value = 1 or 0

FOLDR_DRIVE=<DRIVE LETTER>

Configures the drive letter to be used when mounting the Foldr drive.

Registry Setting
Name = FoldrDrive
Type = REG_SZ (String)
Value = R: (as an example)

DRIVE_TYPE_REMOVABLE=1|0

Configures the drive type to be used when mounting the Foldr drive (1 configures a Removable Drive, 0 configures a Network Drive).

Removable Drive is the default drive type and is recommended in typical installations.  This mode provides improved support for Office files and saving back to the Foldr drive when the document is still open.

For compatibility reasons, the drive should be configured in Network mode in remote desktop sessions.

Registry Setting
Name = DriveTypeRemovable
Type = REG_SZ (String)
Value = 1|0

USER_CAN_CHANGE_DRIVE_TYPE=1|0

Configures whether the user can override the drive type used when mounting the Foldr drive.

Registry Setting
Name = UserCanChangeDriveType
Type = REG_SZ (String)
Value = 1|0

USER_CAN_CHANGE_DRIVE_LETTER=1|0

Configures whether the user can change the drive letter assigned to the Foldr drive.  Note that this settings only takes affect if FOLDR_DRIVE=<DRIVE LETTER> has been set.

Registry Setting
Name = UserCanChangeDriveLetter
Type = REG_SZ (String)
Value = 1|0

SHARES=<LIST OF ENABLED SHARES>

Determines which shares are available to the user through the Windows application.  If the option is not configured or an empty value is set, all shares will be available.

Otherwise, use a comma separated list of share IDs to specify which shares should be available, all others will be hidden from the drive. The share ID can be found in the Foldr Settings >> Shares area (shown in the browser address bar)

Registry Setting
Name = EnabledShares
Type = REG_SZ (String)
Value = 1,2,3,4 (example comma separated values for the share ID)

UPDATES_ENABLED=1|0

Determines whether the update mechanism is enabled.

If disabled, then no checking for updates will be made and the option to check for an update in the system tray context menu will be hidden.

Registry Setting
Name = UpdatesEnabled
Type = REG_SZ (String)
Value = 1|0

SIGN_OUT_ON_EXIT=1|0

Determines whether the user is signed-out when they exit the app.  This would be useful in an environment where more than one user will need to sign into Foldr using the same Windows desktop session.  If this option is enabled, the user is prompted to enter their credentials when the app is next launched.  If enabled, the upload queue is wiped when the app is closed.  As such, users must ensure all uploads have completed before exiting the app or logging out of Windows.

Registry Setting
Name = SignOutOnExit
Type = REG_SZ (String)
Value = 1|0

SSO_LOGIN_BY_DEFAULT=1|0

Determines if the ‘Use Single Sign-On’ checkbox is always checked.  The user may still uncheck the control and sign-on with a username and password if they wish.

If disabled, then when the login dialog is shown, the ‘Use Single Sign-On’ is only checked when the user has previously enabled SSO.

Registry Setting
Name = SSOLoginByDefault
Type = REG_SZ (String)
Value = 1|0

SERVER_OS_USING_DRIVE=<DRIVE LETTER>

A convenience option (recommended for deployments to a Windows Server O/S) which overrides the following options with:

  • FOLDR_DRIVE=<DRIVE LETTER>
  • DRIVE_TYPE_REMOVABLE=0
  • USER_CAN_CHANGE_DRIVE_LETTER=0
  • USER_CAN_CHANGE_DRIVE_TYPE=0

Registry Setting
Name =
Type = REG_SZ (String)
Value =

CACHE_EXPIRY_DAYS=1|0

Sets the number of days that files are cached on the user’s local filesystem.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = CacheExpiryDays
Type = REG_SZ (String)
Value = 1, 5, 7, 14 or 28

CERTIFICATE_PROMPTS=1|0

Determines whether the user is prompted if the server they are connecting has an untrusted / expired SSL certificate.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = CertificatePrompts
Type = REG_SZ (String)
Value = 1|0

UPLOAD_NOTIFICATIONS=1|0

Determines whether the a pop-up notification is displayed when a file is queued for upload.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = UploadNotifications
Type = REG_SZ (String)
Value = 1|0

SHOW_WINDOWS_SHORTCUTS=1|0

Determines whether the Windows Shortcuts are shown on the Foldr drive.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = ShowWindowsShortcuts
Type = REG_SZ (String)
Value = 1|0

OFFICE_AUTO_CHECKOUTS=1|0

Determines whether the Microsoft Office files are automatically checked-out when they are opened.  This feature requires that the drive is mounted as a Network Drive.

When a value is assigned to this setting,  the user will be unable to override the configured value

Registry Setting
Name = OfficeAutoCheckouts
Type = REG_SZ (String)
Value = 1|0

USE_MY_FILES=1|0

Determines whether ‘my files’ and ‘bookmarks’ are shown in the root of the Foldr drive. When enabled, the shares available to the user will be contained within the ‘my files’ directory. When disabled, the shares will be shown in the root of the Foldr drive.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = UseMyFiles
Type = REG_SZ (String)
Value = 1|0

OPEN_DRIVE_AT_STARTUP=1|0

Determines whether ‘my files’ and ‘bookmarks’ are shown in the root of the Foldr drive. When enabled, the shares available to the user will be contained within the ‘my files’ directory. When disabled, the shares will be shown in the root of the Foldr drive.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = OpenDriveAtStartup
Type = REG_SZ (String)
Value = 1|0

CLEAR_CACHE_ON_EXIT=1|0

Determines whether the cache is cleared when Foldr exits.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = ClearCacheOnExit
Type = REG_SZ (String)
Value = 1|0

SSO_AUTO_SIGN_IN=1|0

When Foldr is started up, and single-sign-on is available, Foldr will attempt to sign in automatically using SSO.

When a value is assigned to this setting, the user will be unable to override the configured value.

Registry Setting
Name = SSOAutoSignIn
Type = REG_SZ (String)
Value = 1|0

App Defaults

Option Default Value
FOLDR_SERVER empty
REQUIRES_ANTIVIRUS 1
AV_GRACE_MINUTES Any numeric value
DETECT_RENAME_THREAT 1
DETECT_EXTENSIONS_THREAT 1
FOLDR_DRIVE The first available drive letter working in reverse from Z:
DRIVE_TYPE_REMOVABLE 1
USER_CAN_CHANGE_DRIVE_TYPE 1
USER_CAN_CHANGE_DRIVE_LETTER 1
SHARES Empty (all shares available)
UPDATES_ENABLED 1
SIGN_OUT_ON_EXIT 0
SSO_LOGIN_BY_DEFAULT 0
SERVER_OS_USING_DRIVE Not applicable (see individual settings)
CACHE_EXPIRY_DAYS 7
CERTIFICATE_PROMPTS 1
UPLOAD_NOTIFICATIONS 1
SHOW_WINDOWS_SHORTCUTS 0
OFFICE_AUTO_CHECKOUTS 0
USE_MY_FILES 1
OPEN_DRIVE_AT_STARTUP 1
CLEAR_CACHE_ON_EXIT 0
SSO_AUTO_SIGN_IN 0

Need more help?

Get in touch with our friendly help desk who will be happy to assist you, support@foldr.io