Foldr Zen Zone

Knowledge Base

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.

Sophos Antivirus

At the time of updating this article (1st November 2022) it is currently NOT recommended to use Foldr on macOS systems with Sophos Antivirus installed. Sophos have acknowledged an issue causing system instablity where macFUSE is installed.

They are working on a fix for this issue and hope to make this available early in 2023. This article will be updated as and when we get more information.

Configurable Options

– FOLDR_SERVER

– UPDATES_ENABLED

– SIGN_OUT_ON_EXIT

– VOLUME_NAME

– SHARES

– OPEN_DRIVE_DEFAULT

– DETECT_RENAME_THREAT

– DETECT_EXTENSIONS_THREAT

– GATEKEEPER_REQUIRED

– FILEVAULT_REQUIRED

– USE_MY_FILES

– PRESERVE_WRF_ON_SIGN_OUT

– USE_OFFICE_ASSIST

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

Examples:

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

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

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

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 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist DETECT_RENAME_THREAT 1 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist DETECT_EXTENSIONS_THREAT 1 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist GATEKEEPER_REQUIRED 1 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist FILEVAULT_REQUIRED 1 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist USE_MY_FILES 1 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist PRESERVE_WRF_ON_SIGN_OUT 1 or 0
sudo defaults write /Library/Preferences/it.minnow.FoldrAdmin.plist USE_OFFICE_ASSIST 1 or 0


Details

FOLDR_SERVER

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.

UPDATES_ENABLED
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.

SIGN_OUT_ON_EXIT

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.

VOLUME_NAME

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.

SHARES

Determines which configured storage items are available to the user through Finder.  If the option is not configured or an empty value is set, all storage items 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 >> Files & Storage tab (shown next to the share name when editing the share in question)

OPEN_DRIVE_DEFAULT

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

DETECT_RENAME_THREAT

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.

DETECT_EXTENSIONS_THREAT

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.

GATEKEEPER_REQUIRED

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.

FILEVAULT_REQUIRED

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

USE_MY_FILES

Determines whether ‘My Files’ and ‘Bookmarks’ are shown in the root of the Foldr drive. When enabled, the storage locations available to the user will be contained within the ‘My Files’ directory. When disabled, the storage locations will be shown in the root of the Foldr drive.

PRESERVE_WRF_ON_SIGN_OUT

Working File Recovery (WFR) is a feature that provides an in-app recycle bin for files that have been worked on from the Foldr drive.  The app and it will keep a copy of each document/file in the WFR location for every save action.

By default files in the WFR location will remain if the app is quit (or machine is shutdown).  However, if the user signs out of the app, the default behaviour is for files in the WFR store to be deleted.  Foldr will automatically manage files in the WFR store in-line with the setting to manage the cache (Clear cached files after x days).  Manually clearing the cache will not affect files in the WFR store.

The admin option PRESERVE_WFR_ON_SIGN_OUT allows the administrator to change the app behaviour so files in the WFR store are not deleted if the user signs out of the app.

If the argument is set to 1 – Working files in the filesystem WFR folder are preserved on sign-out.  The user will be unable to configure the setting.
If the argument is set to 0 – Working files in the filesystem WFR folder are removed on sign-out.  The user will be unable to configure the setting.

USE_OFFICE_ASSIST

Determines whether locally installed Office apps will open Office documents hosted in Office 365 locations directly via their Online URL.  This removes the Foldr server and default save/upload mechanism from the workflow and allows the Office apps to behave natively with 365 documents (from OneDrive, Teams or SharePoint Online).  Autosave and will automatically enabled in the Office apps and collaborative editing will function as normal with other Office 365 users.

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
Every journey begins with a single step

There can be many paths to a desired document. Let Foldr be your guide, wherever the destination...

Find File Zen