Mass deployment with preconfigured settings for Mac Follow

Overview

IT Admin may choose to install Zoom with preconfigured settings on the Zoom Client for Mac. This installation requires configuring a .plist file and installing it along with the Zoom for IT Admins Installer for Mac.

Settings can be enforced and/or set as just the default settings, which the end-user can still modify after deployment. 

Note: Boolean values for plist keys can be noted as the following:

• The value for False can be represented by either 0, NO, no, false, or FALSE
• The value for True can be represented by either 1, YES, yes, true, or TRUE

This article covers: 

• Downloading the installer
• Priority of settings
• Creating and configuring the .plist file
  • Recommend default settings
  • General settings
  • Meeting settings
  • Chat settings
• Deploying Zoom

Learn how to install with preconfigured settings on a Windows machine.

Downloading the Installer

Go to Download Center, and click on Download for IT Admin; or download directly from https://zoom.us/client/latest/ZoomInstallerIT.pkg

Priority of settings

Settings can be configured in multiple places. While some can only be configured by the Zoom Admin or IT Admin, some settings can be configured by the end-user as well. If settings conflict, Zoom will use the following priority:

• Priority 1: Setting deployed via us.zoom.config.plist NOT set under PackageRecommend
• Priority 2: Web setting locked for the account or group
• Priority 3: Client setting selected by the user
• Priority 4: Settings deployed via us.zoom.config.plist set under PackageRecommend
• Priority 5: Web settings that are not locked

Creating and configuring the .plist file

If you want to configure options for the Zoom desktop client on Mac, you need to create a .plist file. If you don't configure the .plist file, Zoom will be deployed with the default configuration.

Recommended default settings

Settings can be configured via plist, either as enforced or as recommended defaults using the PackageRecommend key. If the settings are listed under the PackageRecommend key, the Mac client will install with those settings configured, but users will be able to change those options after deployment.

To set the settings as recommended settings, move or add the settings under <key>PackageRecommend</key>. For example, if you want to have the Mac client "Automatically enter full screen when viewing shared content" by default, but not allow Google or Facebook login, the plist file would be:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
 <key>nogoogle</key>
 <true/>
 <key>nofacebook</key>
 <true/>
 <key>PackageRecommend</key>
      <dict>
          <key>ZAutoFullScreenWhenViewShare</key>
          <true/>
      </dict>
</dict>
</plist>

General settings

The .plist file can contain the following keys:

*Note: Please have an account admin or owner contact Support to acquire your account ID. 

Meeting Settings

The .plist file can contain the following keys:

For the following settings, all value types are Boolean.

Description	Default	Plist Key
Always use PMI for instant meetings	Disabled	usepmi
Disable Camera by default	Disabled	ZDisableVideo
Disable sending video from the Zoom Client	Disabled	zdisablesendvideo
Disable receiving video from the Zoom Client	Disabled	zdisablerecvvideo
Disable use of computer audio on the Zoom Client	Disabled	disablecomputeraudio
Enable Orginal Sound for audio	Disabled	enableoriginalsound
Automatically join VoIP	Disabled	ZAutoJoinVoip
Automatically adjust microphone levels	Enabled	audioautoadjust
Enables echo cancellation for the microphone audio	Disabled	EnableEchoCancellation
Uses the system default speaker when using computer audio	Enabled	setusesystemdefaultspeakerforvoip
Uses the system default speaker when using microphone audio	Enabled	setusesystemdefaultmicforvoip
Automatically enable dual monitor	Disabled	ZDualMonitorOn
Automatically enter full screen when viewing shared content	Enabled	ZAutoFullScreenWhenViewShare
Automatically fit to window when viewing shared content	Enabled	ZAutoFitWhenViewShare
Disables annotation when screen-sharing or viewing a screen share	Disabled	zdisableannotation
Enables Do Not Disturb when sharing	Enabled	EnableDoNotDisturbInSharing
Disables the use of the Whiteboard feature in-meeting	Disabled	disablewhiteboard
Allows sharing of video clips when screen sharing	Enabled	enablesharevideo
Allows the sharing of audio only when screen sharing	Enabled	enableshareaudio
Full Screen when starting or joining a meeting	Disabled	FullScreenWhenJoin
Always show meeting controls (Disable auto-hide toolbar)	Disabled	AutoHideToolbar
Enable HD Video by default	Disabled	ZUse720PByDefault
Remote control all applications	Enabled	ZRemoteControllAllApp
Hide non-video participants by default	Disabled	ZHideNoVideoUser
Always mute microphone when joining a meeting	Disabled	MuteVoipWhenJoin
Show the length of time that the user has been in a meeting	Disabled	ShowConnectedTime
Confirm before leaving a meeting	Enabled	ConfirmWhenLeave
Disable in-meeting file transfer	Disabled	zDisableFT
Disable in-meeting 3rd party file transfer	Disabled	DisableMeeting3rdPartyFileStorage
Disable Screen Share when starting or joining a meeting	Disabled	DisableScreenShare
Disables Remote Control when screen sharing	Disabled	disableremotecontrol
Enable to  prevent incoming call notifications while in a meeting.	Disabled	HidePhoneInComingCallWhileInMeeting
Enable to allow clipboard access during remote control sessions.	Disabled	EnableShareClipboardWhenRemoteControl
Disables 1:1 remote support when screen sharing	Disabled	disableremotesupport
Enable mirroring of shared video	Disabled	EnableMirrorEffect
Enables side-by-side mode by default	Disabled	enablesplitscreen
Disables Local Recording from the Zoom Client	Disabled	zdisablelocalrecord
Disables Cloud Recording from the Zoom Client	Disabled	zdisablecmr
Disables use of the Virtual Background feature	Disabled	disablevirtualbkgnd
Disable video filters	Disabled	DisableVideoFilters
Split traffic across different ports for easier identification Video share: 8801 Screensharing: 8802 Audio: 8803	Disabled	EnableIndependentDataPort
The Zoom Client will verify the server certificate	Disabled	EnableSSLVerification
Enables a reminder for upcoming meetings	Disabled	EnableRemindMeetingTime
Enables Gallery View to display up to 49 participants per screen	Disabled	Enable49Video
Enables spotlight of your video when speaking	Disabled	EnableSpotlightSelf

The following Meeting Settings are String values: 

Description	Default	Plist Key
Limit the Maximum amount of bandwidth by the Mac client	Disabled	bandwidthlimitup
Limit the Minimum amount of bandwidth used by the Macclient	Disabled	bandwidthlimitdown
Set path for local meeting recording files	/Users/User Name/Documents/Zoom	recordpath
Set proxy bypass rule for the Zoom Client	Disabled	proxybypass
Set the proxy server for the Zoom Client	Disabled	proxy
Set proxy server to client with PAC URL for the Zoom Client	Disabled	proxypac
Set noise suppression level Auto - 0 Low -1 Medium - 2 High - 3	Auto (0)	SetSuppressBackgroundNoiseLevel

Chat settings

The .plist file can contain the following keys:

Deploying Zoom

An example .plist file with settings from above enabled by default can be found here.

Once the .plist file is complete, it will need to be named us.zoom.config.plist. When deploying, as long as this file is in the same folder as the ZoomInstallerIT.pkg, the installation will automatically put the .plist file into the /Library/Preferences folder.

You can also deploy IT packages through JAMF, Intune, AirWatch and other solutions, and push the .plist through them. The Zoom client will also try to read the us.zoom.config.plist. located in the /Library/Managed Preferences folder.