--- title: "Installation" slug: "installation" description: "RapidIdentity Client for Windows installation for multi-factor (MFA) authentication to Windows devices using RapidIdentity" tags: ["Device Authentication", "Windows Client", "Administrator", "SSO", "MFA"] updated: 2025-12-11T00:22:22Z published: 2025-12-11T00:22:22Z canonical: "help.rapididentity.com/installation" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://help.rapididentity.com/llms.txt > Use this file to discover all available pages before exploring further. # Installation Installation of RapidIdentity Client for Windows can be done interactively or silently by using command-line installation options. To begin both installation options, one must be logged in as a local administrator on the device. Then, follow the steps for the corresponding installation option below. **Note:** RapidIdentity Client for Windows is for RapidIdentity Cloud only and is not meant for on-premise systems. Installing the RapidIdentity Client for Windows requires an API Key from the RapidIdentity Cloud tenant. An API Key is associated with a **Service Identity** in RapidIdentity. Instructions for creating a **Service Identity** are [here](/docs/configuration#creating-an-api-key-in-rapididentity). ## **Interactive Installation** For Domain-Joined installments, the following prerequisites are required: - Available Authentication into RapidIdentity Cloud version 2021.7.27 or later (base requirement for all) - Windows 10 Machine must be domain-joined - Users' identities exist in both the RapidIdentity User Store and Active Directory with synced passwords - An API key has been assigned to the **Authentication API Consumer** role for the appropriate Service Identity (base requirement for all) - For more information on the latest version, please refer to the following resources: - [What's New?](/v1/docs/release-170-whats-new) 1. To install the latest version of the RapidIdentity Client for Windows, right click the link below to Save As. Once the RapidIdentity Client for Windows installer is downloaded, right-click on the file to install. [](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/RapidIdentity Client for Windows(2).msi)RapidIdentity Client for Windows37.36 MB[](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/RapidIdentity Client for Windows(2).msi) *Updated on 12/8/2025* 1. When presented with the Windows Setup Wizard, click **Next** to begin the installation. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-cu2vltcm.png) 2. Fill in the following fields as noted below. Click 'Next' when complete. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/image-20241230-110010 (1).png) 1. **Domain**: Accounts will authenticate to this domain. **NOTE**: Use DOT (.) to use a local account in a Non-Domain-joined installation or the NetBIOS name of the Domain in a Domain-joined installation. 2. **Server URL**: Server URL. **NOTE**: Server URL should start with 'https://' 3. **API Key**: Secret API Key generated in RapidIdentity Service Identities Server. 1. For further details on where to locate the Secret Key, see Step 6 of [this article](https://help.rapididentity.com/docs/configuration#assign-the-key-to-the-service-identity). 3. Select the folder in which the file is to be installed and click **Next**. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-khpfdwea.png) 4. Click **Install** on the Ready to install window. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-g1g3ta8d.png) 5. Click **Yes** to allow this app to make changes to the device if applicable. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-fd5wpko1.png) 6. Once the installation is complete, click **Finish** to exit the Setup Wizard. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-idn3c566.png) ## **Command-Line Installation** From an administrative command prompt (or remote deployment package), execute the RapidIdentity Client for Windows install with the required command-line options. Below are the minimum values that need to be configured. - Set API Key: **APIKEY=** - Set the URL: **SERVER_URL=** - Set the Domain: **DOMAIN=** 1. To install using the command line, open the Command Prompt and right-click on it from under the "Best match" section, and select **Run as administrator**. 2. Navigate to the location where the "RapidIdentity Client for Windows.msi" file is located, and execute the following command. The install will proceed silently and will only reboot the device if /forcerestart is added to the command line. ```actionscript msiexec.exe /i "Path for the installer" /quiet /passive APIKEY="api key string" SERVER_URL="tenant url"  DOMAIN="domain name" ENABLE_FAST_USER_SWITCHING="0 or 1" Example : msiexec.exe /i "C:\AuthC_install\RapidIdentity Client for Windows.msi" /quiet /passive APIKEY="$s5TOu3vlTlabyHe9Q17AgQ==.1KRQp0gAoOv0TD5uVWQ=$" SERVER_URL="https://iac53adaf6cd3d440c8f5765dc08fc8.com"  DOMAIN="." ENABLE_FAST_USER_SWITCHING="1" ```

Deploying the Windows Client with Command Line Parameters

 The Windows Client provides a mechanism to automate installation via the command line for administrative installations. This information could be used by administrators to create a Command Line script that is run during user login on machines the client should be installed on. 1. Download the Windows Client Installer via the link at the top of this article. 2. Open the command prompt as an admin user on the Windows 10 machine. 3. Run the following command: ```actionscript msiexec.exe /i "RapidIdentity Client for Windows.msi" /quiet /passive APIKEY=" ``` ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-06mksruo.png) Note: Once the command has been run, the installation process starts in the background. However, it can be tracked in Task Manager if desired. ![](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/installation-image-xv1f8bb2.png) The Windows Client should proceed to install and should be present on the appropriate machines upon completion. Please Note: - The Windows Authentication Client does not support the Remote Desktop Protocol. - If you're using external Logo URLs ensure that your firewall isn't blocking the URL. ## Related - [Windows Auth Client Project Setup, Installation, and Upgrade on VM](/authclient-project-setup-and-installation-and-upgrade-on-vm.md) - [Windows Authentication Client](/rapididentity-windows-authentication-client.md) - [Uninstalling Windows Client](/uninstalling-windows-client.md) - [Authentication for Windows Client](/authentication-for-windows-client.md) - [Silent Install for Windows Client using Command Line Parameters](/silent-install-for-windows-client-with-command-line-parameters.md) - [Known Issues for Windows Authentication Client](/known-issues-windows-client.md) - [Deploy MSI Installer for Windows Authentication with Windows Group Policy Object (GPO)](/deploy-msi-installer-for-windows-authentication-with-windows-group-policy-object-gpo.md) ## Attachments - [RapidIdentity%20Client%20for%20Windows%2007_2024(1).msi](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/RapidIdentity%20Client%20for%20Windows%2007_2024(1).msi)