> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.adaptiva.com/platform-install/client-install-and-uninstall/deploy-clients/deploy-clients-grouppolicy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
