> 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/deploy-clients/deploy-clients-grouppolicy.md).

# Deploy clients with Group Policy

Client Installation using ConfigMgr

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.

   ![](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-e41d3f3477c0b1d4e8b355764464ae20a5824798%2Forca.png?alt=media)
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](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-1945dcaf66a653a2388344d9a259bd18248e0ec6%2Fgpm-new-gpo.png?alt=media)
2. In the Group Policy Management Editor, expand **Computer Configuration > Policies > Software Settings**.
3. Right-click **Software installation** and select **New > Package**.

   ![Software installation](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-2d93906a4211833a0598424448207b34481396f5%2Fgpo-new-package.png?alt=media)
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**.

   ![](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-c78ed9347fd736ebc4baade645c44ed89eb24de6%2Fdeploy-software-advanced.png?alt=media)
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**.

   ![](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-3ebeb2f0cd14c28975daa8490eb80c82cb42a645%2Fdeployment-modifications.png?alt=media)
8. Click **OK** and close the policy.
9. Target the group policy appropriately. Devices will install the Adaptiva Client at the next system restart.