Deploying & Configuring the macOS app

The macOS drive mapping client provides access to any storage presented through Foldr directly from Finder using a single drive.  On-premise storage locations (shares) can be presented alongside Cloud Storage

System Requirements

macOS 10.9 or higher
FUSE for macOS (latest available is recommended)

Where to get the app

The latest app release for  macOS is available here:

Foldr for macOS

Deploying FUSE for MacOS

IMPORTANT – Foldr for macOS relies on FUSE to function correctly.  If FUSE is not already installed, a user will be prompted to install it the first time they launch the app which in turn will require an administrative password.

To avoid these prompts, the administrator should manage the FUSE installation separately from Foldr.

FUSE for macOS

Deploying Foldr for macOS

The drive mapping app is provided in standard disk image (.DMG) format can be installed manually or deployed en-masse by enterprise deployment tools, such as JAMF Casper Suite or a compatible MDM solution. Note that we do not provide a .pkg version of the app and Foldr for macOS is not available from the Mac App Store.

The administrator can optionally set various options / preferences to configure the app as required.

Configurable Options











Setting Options

To set app preferences, you are required to use sudo in the Terminal. This could be automated through the use of script of your MDM or macOS management solution supports that functionality:

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin OPTION VALUE


sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin FOLDR_SERVER "my.foldr-server.address"

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin UPDATES_ENABLED 0

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin SIGN_OUT_ON_EXIT 1

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist VOLUME_NAME "newname"

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist SHARES "1,3,5"

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist OPEN_DRIVE_DEFAULT 1

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist DETECT_RENAME_THREAT 1

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist DETECT_EXTENSIONS_THREAT 1

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist GATEKEEPER_REQUIRED 1

sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist FILEVAULT_REQUIRED 1



If the option is absent, then the server address on the sign-in form will be empty until the user configures an account.

If FOLDR_SERVER=”address”, then the specified address will be used on the sign-in form when the user hasn’t yet configured their account.

If the option is absent, then the user is able to configure whether Foldr checks for updates.

If UPDATES_ENABLED=0, then Foldr will not check for updates. The user will not be able to change the setting.

If UPDATES_ENABLED=1, then Foldr will check for updates, by default. The user will be able to change the setting and may also choose to skip updates.


If the option is absent, then the user is able to configure whether Foldr signs-in automatically.

If SIGN_OUT_ON_EXIT=0,  the user does not need to provide login credentials when the app is run.  The user will sign-in automatically and will be unable to change the setting.

If SIGN_OUT_ON_EXIT=1, then the user will need to sign-in manually each time the Foldr app starts. They will NOT be able to change the setting.


Determines the name of the Foldr drive as shown in Finder.  If the volume name has not been set by admin, then we allow the user to change the name in the Drive Preferences.

Volume Naming Limitations:

• Length is greater than zero and less than 30 characters.
• Volume name must not contain a colon.

If the VOLUME_NAME contains an error, it will be ignored and the default name “Foldr” will be shown.


Determines which shares are available to the user through Finder.  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 at the end of the URL when editing a share)


Determines whether the drive should be displayed to the user automatically when it is mounted, i.e. after the user signs in.


Determines whether the app detects rename threats and disconnect the drive immediately if detected. This can include multiple rename attempts in quick succession. If enabled, then the user will not be able to override the setting.


Determines whether the app detects filename/extension threats. This is a pre-defined list of known malicious file extensions. If enabled, then the user will not be able to override the setting.


Determines whether the app requires macOS Gatekeeper protection to be enabled / running. If enabled, then the user will not be able to override the setting.


Determines whether macOS FileVault full-disk encryption is required on the client to allow the drive to mount. If enabled, then the user will not be able to override the setting.

Reading Configured Options

How to read any options that are currently set:

sudo defaults read /Library/Preferences/it.minnow.FoldrAdmin

Deleting Options

To unset an option use the following command:

sudo defaults delete /Library/Preferences/it.minnow.FoldrAdmin OPTION

Need more help?

Get in touch and we'll be happy to assist you, [email protected]

© Minnow IT. Registered in England and Wales with company number 07970411.

Made with in Bristol, UK