You can specify custom options for Drive File Stream, including the default drive letter on Windows, the mount point on Apple macOS, the cache location, bandwidth limits, and proxy settings. These configurations can be set at the user or host level, and persist when Drive File Stream restarts.
If you haven't done so already, download and set up Drive File Stream.
Where to update settings
To set the Drive File Stream options, you update registry keys (Windows) or use the defaults
command (macOS). If you’re not familiar with making these updates, contact your administrator or check your operating system documentation. Additionally, note that administrators can set override values that end users can't change.
Windows
Host-wide | HKEY_LOCAL_MACHINE\Software\Google\DriveFS |
User only | HKEY_CURRENT_USER\Software\Google\DriveFS |
Override | HKEY_LOCAL_MACHINE\Software\Policies\Google\DriveFS |
macOS
Host-wide | /Library/Preferences/com.google.drivefs.settings |
User only | ~/Library/Preferences/com.google.drivefs.settings |
Override | /Library/Managed Preferences/com.google.drivefs.settings.plist |
macOS examples
Host-wide mount point:
sudo defaults write /Library/Preferences/com.google.drivefs.settings DefaultMountPoint '/Volumes/Google Drive File Stream'
Host-wide trusted certificates file:
sudo defaults write /Library/Preferences/com.google.drivefs.settings TrustedRootCertsFile /Library/MyCompany/DriveFileStream/MyProxyCert.pem
User maximum download bandwidth:
defaults write com.google.drivefs.settings BandwidthRxKBPS -int 100
User-enabled browser authentication:
defaults write com.google.drivefs.settings ForceBrowserAuth -bool true
Settings
Set these name and value pairs using the registry keys or defaults
command, as described above. On Windows, create the registry keys if they don't already exist. On macOS, the defaults
command maintains a plist file for settings. You should not modify the plist file directly, as some changes might not be applied.
Setting name | Value type | Value description |
---|---|---|
AutoStartOnLogin |
Windows—DWORD*
|
Start Drive File Stream automatically on session login. |
BandwidthRxKBPS |
Windows—DWORD
|
Maximum downstream kilobytes per second. |
BandwidthTxKBPS |
Windows—DWORD
|
Maximum upstream kilobytes per second. |
ContentCachePath Warning: Be cautious about clearing the Drive File Stream cache to try to fix general problems. Files are moved here before they're uploaded. If you clear the cache before an upload is complete, that file will be lost. |
String |
Sets the path to the content cache location on a connected APFS, HFS+, or NTFS file system. Windows— |
ContentCacheMaxKbytes |
Windows—QWORD
|
Sets the limit on content cache size in kilobytes. The limit is capped at 20% of the available space on the hard drive (regardless of the setting value).The setting does not apply to files made available offline or files that are in the process of uploading. |
DefaultMountPoint |
String |
Windows—Set a mounted drive letter or a path on an existing drive. macOS—Set the mounted drive path. You can include tilde (~) or environment variables in the path. |
DisableMeetOutlookPlugin |
Windows—DWORD*
|
Available with Drive File Stream version 39 and later. Disables the Microsoft Outlook Meet plugin that's bundled with Drive File Stream. |
DisableOnboardingDialog |
Windows—DWORD* macOS—Boolean* |
Disables the welcome window for new users. |
DisableOutlookPlugin |
Windows—DWORD*
|
Disables the Microsoft Outlook Google Drive attachment plugin that's bundled with Drive File Stream. |
DisableRealTimePresence |
Windows—DWORD*
|
Disables real-time presence in Microsoft Office. |
ForceBrowserAuth |
Windows—DWORD*
|
Use browser authentication. |
MinFreeDiskSpaceKBytes |
Windows—QWORD
|
Controls the amount of local space used by Drive File Stream's cache. Stops writing content to the disk when free disk space gets below this threshold, in kilobytes. |
Proxy settings: |
||
DirectConnection |
Windows—DWORD*
|
This bypasses proxy configurations. |
DisableCRLCheck |
Windows—DWORD*
|
This disables checking Certificate Revocation Lists (CRLs) provided by certificate authorities. |
DisableSSLValidation |
Windows—DWORD*
|
This disables validating SSL traffic. Traffic will still be encrypted, but we will not validate that the SSL certificates of the upstream servers are all valid. This is inherently insecure. It would allow a man-in-the-middle attack against traffic to Google Drive.
Only settable host-wide. |
TrustedRootCertsFile |
String |
This is the full path to an alternate file to use for validating host SSL certificates. It must be in Privacy Enhanced Mail (PEM) format. Set this if your users are on networks with decrypting proxies. |
* For boolean values, use 1 for true and 0 for false (Windows), or use true and false (macOS).
Related topics
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.