> For the complete documentation index, see [llms.txt](https://docs.adaptiva.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptiva.com/platform-install/client-install-and-uninstall/deploy-clients/deploy-clients-grouppolicy.md).

# Deploy clients with Group Policy

Deploying software through Group Policy cannot use the standard command line syntax. The properties that are set via the command must be set in a Windows Installer transform file. A variety of tools are available that can be used for this task. [Orca](https://learn.microsoft.com/en-us/windows/win32/msi/orca-exe) is a free tool available from Microsoft and is part of the Windows SDK.

## Create a Transform File (MST)

Download and install the latest [Windows SDK](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/).

Follow these steps to create a Windows Installer transform file (MST) using Orca.

1. Open Orca, select **File > Open** and select the `adaptiva-client-p2p-<version>-windows.msi`.
2. In the menu bar, select **Transform > New Transform** to create a new transform file.
3. Select the Property table in the Tables list on the left.

   ![](/files/oXl5jHI33ejgyeDfVEHC)
4. In the Property table, modify the following values:

   * **SOURCEUNCPATH** = `<Path to the Adaptiva installer>`
   * **SERVERNAME** or **SERVERIP** = `<FQDN>` or `<IP Address>` of the Adaptiva Server

   If you are using the Cloud Relay service, set the following properties:

   * **CLOUDRELAY**=`1`
   * **SERVERGUID**=`<GUID>`
   * **PASSWORD**=`<password>`

   If you are using HTTP for client communications, set the following properties:

   * **SERVERURL**=`<ServerURL:port>`
5. Click **Transform > Generate Transform** and save the MST file.
6. Close the Orca tool.

## Create a File Share

1. Create a content source folder as follows:

   `<Drive>:<Path>\Adaptiva\Client`
2. Copy the Adaptiva Client MSI and MST files into the Client folder.
3. Share this folder on the server as **AdaptivaClient** with the following permissions:

   Share permissions: **Everyone: READ**

   NTFS permissions: **Domain Computers: Read and Execute, List, Read**

## Create a Group Policy Object

1. Open Group Policy Management and create a new or edit an existing GPO.

   ![New GPO](/files/j1won3m0zdzPleajO8Yj)
2. In the Group Policy Management Editor, expand **Computer Configuration > Policies > Software Settings**.
3. Right-click **Software installation** and select **New > Package**.

   ![Software installation](/files/mZOSIH7AxUWd4lsMW9oF)
4. In the **Open** dialog, navigate to the Adaptvia Client share location and select the `adaptiva-client-p2p-<version>-windows.msi`.
5. In the **Deploy Software** dialog, select **Advanced** and then click **OK**.

   ![](/files/mPJFJeV0dRLeHrxiYcBa)
6. In the Adaptiva Peer to Peer Client Installer Properties dialog, select the **Modifications** tab, and click **Add**.
7. Navigate to to the Adaptvia Client share location, select the MST file, and click **Open**.

   ![](/files/6eXgF9PxratG8uUesaZJ)
8. Click **OK** and close the policy.
9. Target the group policy appropriately. Devices will install the Adaptiva Client at the next system restart.
