As an administrator, you can install Webex App using the MSI file on Windows or the DMG file on Mac. You can include command line parameters to improve user experience. Webex App periodically checks for newer versions to automatically upgrade the app. If your organizations uses Webex for Government, see Webex for Government app installation instead.
Windows desktop minimum requirements
Intel Dual-Core CPU 2.XX GHz or AMD processor.
- Minimum 4 GB RAM
Windows 10 or later OS.
Make sure your drivers are up-to-date. For further information on the latest drivers for some graphic products, see the following:
Microsoft Edge WebView2 component.
This improves bandwidth consumption for updates with a reduced app size. Provides the capabilities to make memory improvements.
Mac desktop minimum requirements
MacOS 10.13 and later.
M1 chip or Intel CPU-based
Minimum 4 GB RAM
As an administrator, if you want to access a specific version of the app, use one of the following links:
You can download the DMG file from the following link:
Macs with Intel chips: https://binaries.webex.com/WebexTeamsDesktop-MACOS-Gold/Webex.dmg
Macs with M1 chips: https://binaries.webex.com/WebexDesktop-MACOS-Apple-Silicon-Gold/Webex.dmg
This article is about installing the desktop version of Webex App for Mac or Windows. For Linux, see Webex App for Linux.
Webex App installs to the same system folder every time it updates to a new version.
You can install Webex App either per computer or per user. Either the users of an IT administrator can install it.
Webex App installs to the following folder by default:
Users can download and then run the installer file (msi). They don't need administrator access privileges on their computer.
The browser automatically detects if the user's operating system is 32 or 64 bit and downloads the correct version of Webex App.
Administrators can run the installer with extra privileges and can choose per computer installation and the installation directory.
Which MSI install package should I use?
These are the differences between the packages:
Localized or non-localized package: Users can choose a localized package if they want Webex App to install in the language of their operating system.
As an administrator doing a bulk install with a third-party distribution mechanism, you must deploy a non-localized package. Users can still use Webex App in their preferred language (if Webex supports that language).
If you bulk install Webex App with a localized package, you may have trouble when uninstalling Webex App.
32-bit or 64-bit package: Choose the package that matches the architecture of the target Windows operating systems.
App only package: You can choose this option in most situations. The package installs only Webex App. Webex App downloads the desktop meeting app components if necessary.
There are some exceptions when you may need the bundle instead.
Bundle package: This package installs both Webex App and the desktop meetings app. Only use the bundle package in the following situations:
- You’re installing in a secure environment that blocks the users' computers from downloading software. If Webex App can't download meetings components, people may have usability problems joining meetings with the app.
- You haven’t yet fully migrated to Webex App and your users still need the separate desktopMeetings app.
|Description||Is localized?||OS architecture||Install package download link|
|Webex App only||Localized||32 bit||https://binaries.webex.com/WebexTeamsDesktop-Windows-Gold/Webex_x86.msi|
|Webex App only||Non-localized (EN)||32 bit||https://binaries.webex.com/WebexTeamsDesktop-Windows-Gold/Webex_x86_en.msi|
|Webex App only||Localized||64 bit||https://binaries.webex.com/WebexTeamsDesktop-Windows-Gold/Webex.msi|
|Webex App only||Non-localized (EN)||64 bit||https://binaries.webex.com/WebexTeamsDesktop-Windows-Gold/Webex_en.msi|
|Webex App and desktop meetings bundle||Localized||64 bit||https://binaries.webex.com/Webex-Desktop-Windows-x64-Combined-Gold/WebexBundle.msi|
|Webex App and desktop meetings bundle||Non-localized (EN)||64 bit||https://binaries.webex.com/Webex-Desktop-Windows-x64-Combined-Gold/WebexBundle_en.msi|
Examples here use the msiexec utility from Microsoft. See https://docs.microsoft.com/en-us/windows/win32/msi/using-windows-installer for more details.
These are the command-line parameters you can use with a Webex App MSI install package:
When you set
ALLUSERS=1to specify a per computer installation, you must have administration access privileges. See https://docs.microsoft.com/en-us/windows/win32/msi/allusers for more details.
You can include
/qnto install without user interaction. For example:
msiexec /i c:\work\Webex.msi /qn.
Set this property TRUE to accept the end-user license agreement on behalf of users. The installer doesn't prompt users to accept the end-user license agreement.
msiexec /i c:\work\Webex.msi ACCEPT_EULA=TRUE ALLUSERS=1.
The end-user license agreement doesn't appear when you set either of the following registry entries to
Specifies whether Webex App automatically runs when Windows starts up.
The default value is
TRUE. You need administrative privileges to change it.
msiexec /i c:\work\Webex.msi AUTOSTART_WITH_WINDOWS=true ALLUSERS=1
Webex App automatically starts when Windows starts up (default). This setting enables and grays out the Start Webex when my computer starts control, so the user can't change it.
msiexec /i c:\work\Webex.msi AUTOSTART_WITH_WINDOWS=false ALLUSERS=1
Webex App doesn't automatically start with Windows. Users can change Start Webex when my computer starts in the Webex App settings.
Specifies the theme used for the Webex App.
The default value is
Dark. You need administrative privileges to change it.
Users can change the theme in Webex settings.
msiexec /i c:\work\Webex.msi DEFAULT_THEME="Light" ALLUSERS=1
Specifies the light theme for Webex App.
msiexec /i c:\work\Webex.msi DEFAULT_THEME="Dark" ALLUSERS=1
Specifies the dark theme for Webex App.
Specifies whether to delete or retain user database and log files.
The default value is
0which retains the database and logs during install.
msiexec /i c:\work\Webex.msi DELETEUSERDATA=1 ALLUSERS=1
Removes user database and logs during install.
This parameter allows you to streamline the Webex App sign-in process for users by specifying their email address or a pattern that indicates how to derive the email address.
msiexec /i c:\work\Webex.msi EMAILfirstname.lastname@example.org email@example.com into the Webex sign-in flow.
You can use the following values with the EMAIL parameter:
User's email address (example: firstname.lastname@example.org)—Sets an actual email address to prepopulate the sign-in flow. Don't use with the ALLUSERS=1 parameter because it represents just one email address. This isn't recommended for devices that have multiple users.
msiexec /i Webex.msi EMAILemail@example.com
$userPrincipalName—Instructs Webex to retrieve the user's User Principal Name (UPN) from Windows at the time of sign in. You can use this for devices with multiple users.
msiexec /i Webex.msi EMAIL=$userPrincipalName ALLUSERS=1
$mail—Instructs Webex to retrieve the user's email address, if available, from LDAP/Active Directory at the time of sign in. You can use this for devices with multiple users.
msiexec /i Webex.msi EMAIL=$mail ALLUSERS=1
$SAMAccountName—Instructs Webex to retrieve the user's SAMAccountName from Windows at the time of sign in. This is typically used for legacy environments. You can use this for devices with multiple users.
msiexec /i Webex.msi EMAIL=$SAMAccountName ALLUSERS=1
Combining the EMAIL parameter with an authentication method, such as Kerberos or mTLS, allows users to sign in automatically.
When you use the EMAIL parameter, users can't change the Webex identity they use to sign in.
Specifies whether Webex App registers with Microsoft Outlook for presence integration. You need administrative privileges to change it.
The default value is
msiexec /i c:\work\Webex.msi ENABLEOUTLOOKINTEGRATION=1 ALLUSERS=1
Webex App registers with Microsoft Outlook for presence integration on Windows.
Users can change Connect Webex to Microsoft Outlook in Webex settings.
msiexec /i c:\work\Webex.msi ENABLEOUTLOOKINTEGRATION=0 ALLUSERS=1
Webex App doesn’t register with Microsoft Outlook for presence integration on Windows (default).
This setting grays out (disables) the Connect Webex to Microsoft Outlook control for all users. You must have administration access privileges to change this option.
Applies only to the bundle install packages. Locks the meetings desktop app if it’s a compatible version with the meeting site. You need administrative privileges to change it.
msiexec /i WebexBundle.msi FORCELOCKDOWN=LockWhenCompatible
Specifies the install folder for the Webex App.
msiexec /i c:\work\Webex.msi INSTALL_ROOT="C:\Program Files" ALLUSERS=1
Installs the WebView2 embedded browser from Microsoft when installing Webex App.
Webex App requires this embedded browser. Learn more about WebView2 and Webex.
msiexec /i c:\work\Webex.msi INSTALLWV2=1
Applies only to the bundle install packages. This parameter extends the Webex Meeting client version to be compatible with the meeting site. Webex Meeting client gets a version number that is greater among the
ForceClientSPCompatibleVersionNo. You need administrative privileges to change it.
msiexec /i WebexBundle.msi FORCECLIENTSPCOMPATIBLEVERSIONNO=10
Running the app
Webex App has its own automatic update solution that is independent from the Windows operating system. The app can automatically update without the knowledge of the Windows operating system, so the installed version of the app may be different from the version the user sees while using the app.
To install Webex App, users don't need to have administrator access privileges on their computers.
Users double-click the
Webex.dmg file to install it. By default, you
install Webex App in the Applications folder, however users can drag and drop Webex App to any other directory.
As an administrator, you can use the Mac
defaults command with the
LoginHint argument to prepopulate Webex App with the user's email:
defaults write Cisco-Systems.Spark LoginHint -string "<firstname.lastname@example.org>"
In this command, user email serves as a login hint to auto-advance to password entry screen, post app install and launch. To restrict the login with specific domains or emails, the user email should be a part of the registry.
HKEY_CURRENT_USER/Software/Cisco Spark Native/Params
To disable the prepopulating, use the following command:
defaults delete Cisco-Systems.Spark LoginHint
Running the app
The app has its own autoupdate solution, independent from the operating system's installation mechanism. You only install the app once using the operating system mechanism. After that, the app automatically updates without the knowledge of the operating system. Therefore, the installed version of the app might be a different version than the one you see while using the app.
A new release takes 11 days to roll out to everyone. During those 11 days, users can proactively check for updates. Users can read Update the app to the latest release.
We automatically apply the update after the 11 days rollout window.
If you have Pro Pack for Control Hub, you can check what version of the app your users are on. See the Messaging App Version Report in Analytics for your cloud collaboration portfolio.
When Webex App is running1, it periodically checks to see if there’s a newer version of the app available. When a newer version becomes available, the app automatically downloads the new version and stores it on the local computer:
~/Library/Application Support/Cisco Spark
We store the current version and the new version of the application in these folders. If the upgrade doesn't work out, then the app can fall back.
If we release a patch for a release, we update all organizations within a three-day rollout window.
To uninstall the app use
msiexec /x Webex.msi.
The path of the
To uninstall Webex App, go to the Applications folder and drag Webex App to the trash.
The Webex App virtual desktop app optimizes the audio and video for the virtual desktop environment. Using a thin client, users access Webex App from a remote virtual desktop environment.
You can find the Webex App for Windows VDI software downloads from https://www.webex.com/downloads/teams-vdi.html
For more information on supported features, how to prepare your environment, and deploy the Webex VDI solution, refer to the Deployment guide for Webex for Virtual Desktop Infrastructure (VDI).
As an administrator you can secure the Webex App app on your user's mobile devices. The solutions we support include MDM/MAM with Microsoft Intune, MDM/MAM with AppConfig, app wrapping using the iOS IPA files and the Android AAB files, and admin controls for mobile management
For more information, see Secure mobile devices.