Prerequisites and compatibility

This article lists prerequisites for installing Cloud Drive Mapper (CDM) along with information about supported operating systems and other software.

Prerequisites

  • Minimum requirement: Microsoft Visual C++ Redistributable for Visual Studio 2015-2022 (x64)

  • Minimum requirement: Microsoft Edge WebView2 Runtime

  • Minimum requirement: Microsoft .NET Framework 4.8

  • Mandatory requirement: Microsoft .NET Desktop Runtime 8.

When you deploy CDM using the CloudDriveMapper.msi file, you must ensure you've already installed Microsoft Visual C++ Redistributable for Visual Studio 2015-2022 (x64), Microsoft .NET Desktop Runtime 8, Microsoft Edge WebView2 Runtime, and Microsoft .NET Framework 4.8 on the target device. You can't deploy CDM successfully without first installing these prerequisites. CDM is not compatible with Microsoft .NET Desktop Runtime 9 or higher.

Grant CDM admin consent

Add and approve the CDM client’s integration with your Microsoft 365 tenancy. For more information, see Granting admin consent to Cloud Drive Mapper (CDM).

Guidance for organizations using firewalls, proxies, or web filtering

Whitelist the following URLs if your organization uses firewalls, proxies, or web filtering:

  • https://bifrost.iamcloud.net

  • https://iris.iamcloud.net

  • https://ids.iamcloud.net

  • https://graph.microsoft.com (Global)

  • https://login.microsoftonline.com

  • https://<tenant-name>.sharepoint.com: Replace <tenant-name> with your SharePoint Online tenant name.

  • https://<tenant-name>-my.sharepoint.com: This URL only applies to personal OneDrive sites. Replace <tenant-name> with your SharePoint Online tenant name.

  • http://www.msftconnecttest.com: Ensure you configure the network firewall to allow access to this URL on port 80. You need to do this as this URL doesn’t support HTTPS protocol.

Guidance for US government environments, Germany, or China

For users in US Government environments, Germany, or China, whitelist the following URLs if your organization uses firewalls, proxies, or web filtering::

  • https://login.microsoftonline.us (US Government GCC, GCC High, DoD)

  • https://login-us.microsoftonline.com (US Government Cloud)

  • https://login.microsoftonline.de (Germany)

  • https://login.partner.microsoftonline.cn (China 21Vianet)

  • https://login.chinacloudapi.cn (China 21Vianet)

You can use the Microsoft OpenID Connect endpoint to identify authentication URLs for a specific tenant: https://login.microsoftonline.com/<tenant-id>/.well-known/openid-configuration.

Guidance for multi-geo environments

In multi-geo environments, SharePoint and OneDrive URLs may also include regional geo-locations. For example:

  • https://<tenant-name>nam.sharepoint.com

  • https://<tenant-name>eur.sharepoint.com

Therefore, please whitelist regional SharePoint URLs associated with your multi-geo locations if your organization uses firewalls, proxies, or web filtering.

Compatibility

Operating systems:

  • Recommended minimum requirement: Windows 10 22H2

  • Recommended minimum requirement: Windows 11 21H2

  • Recommended minimum requirement: Windows Server 2016 Long-Term Servicing Branch (LTSB)

  • Recommended minimum requirement: Windows Server 2019 Long-Term Servicing Channel (LTSC)

  • Recommended minimum requirement: Windows Server 2022 (LTSC)

  • Recommended minimum requirement: Windows Server 2025 (LTSC)

CPUs:

  • AMD x64

  • Intel x64

Other software:

  • Microsoft 365 Apps

  • Remote Desktop Services (RDS)

  • Citrix-published applications and desktops

  • Azure Virtual Desktop

Single Sign-On (SSO)

Cloud Drive Mapper (CDM) can be easily integrated with SSO for a secure and seamless authentication experience. When SSO is enabled for your Microsoft 365 tenancy, CDM automatically signs in to your Microsoft 365 account and maps drives configured for your tenancy. CDM can be integrated with SSO solutions from most major providers, including:

  • Microsoft

  • Okta

  • OneLogin

  • Ping Identity

For more information about the most frequently used deployment methods, see Mass deploying Cloud Drive Mapper (CDM) and Deploying Cloud Drive Mapper (CDM) in a virtual desktop infrastructure environment.

If you want to use Cloud Drive Mapper Legacy (aka v2.x) and Cloud Drive Mapper (V3) concurrently, please uninstall Cloud Drive Mapper 2.20.0.1 or below, and install the latest release of Cloud Drive Mapper v2.x (aka Cloud Drive Mapper Legacy).