# Create an MSP App Set

*Applies to: Patch My PC Cloud*

Creating an App Set in Patch My PC (PMPC) Cloud is a two-stage process that involves:

* [Adding Apps to the App Set](#defining-which-apps-to-include-in-the-app-set)
* [Deploying the App Set](#defining-where-to-deploy-an-app-set)

{% hint style="info" %}
**Note**

We do not recommend creating a single App Set that you use to deploy all of the required apps to your customers. Instead, you should consider creating separate App Sets by app function, e.g., core apps (apps that should be installed or available everywhere), utilities that should only be deployed to certain groups or users, etc.

Adopting this approach reduces the impact of working with App Sets on your infrastructure and that of your child companies. Plus, if someone accidentally deletes the wrong App Set, the impact on the targeted users will be reduced, and the time taken to recreate and redeploy the App Set will be reduced.
{% endhint %}

### Adding Apps to the App Set

{% hint style="info" %}
**Info**

[Binary Free Apps](https://docs.patchmypc.com/patch-my-pc-cloud/binary-free-apps) are not currently supported with App Sets.
{% endhint %}

To add apps to an App Set:

1. Sign in to the parent MSP Company at <https://portal.patchmypc.com/>
2. Navigate to **App Sets**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F1zko6hV7Y99pwgkPkbAg%2Fimage.png?alt=media&#x26;token=503326a7-068f-4615-a87b-18387294e8eb" alt="Navigating to “App Sets”" width="563"><figcaption></figcaption></figure>

The **App Sets** page shows any existing App Sets.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FR7Qu6JGtZJVnPI0YI4cf%2Fimage.png?alt=media&#x26;token=063480ef-5111-4cd4-a010-21c12b85e67d" alt="“App Sets” page showing an existing App Sets" width="563"><figcaption></figcaption></figure>

3. Click **Add App Set**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FcOFyltbj0ljAlmZtwkKC%2Fimage.png?alt=media&#x26;token=88fffe74-ca60-4c23-808e-b1f59b03a792" alt="Clicking “Add App Set”" width="563"><figcaption></figcaption></figure>

4. On the **Add App Set** screen, enter a unique name for the new App Set in the **App Set Name** field and click **Add**

![Specifying the name for the new App Set](https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FdbqXPTB3F885hRLco3Ox%2Fimage.png?alt=media\&token=514e467e-488f-40a5-b62b-2284f927b7a5)

The App Set is created and the ***\<appset\_name>*** screen opens (where ***\<appset\_name>*** is the name of the App Set).

{% hint style="success" %}
**Tip**

You can click **Edit Name** beside the App Set name if you want to rename it.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F8zmhdBrlEIcaQamSbYBl%2Fimage.png?alt=media&#x26;token=e273cfe2-4daf-44cb-aa0e-228067e63d19" alt="App Set name screen" width="563"><figcaption></figcaption></figure>

5. To add an application to this App Set, click **Add Application**

{% hint style="info" %}
**Note**

You can add up to 100 apps per App Set, but each app can only be added to an App Set once.

You can also add an [MSP Custom App](https://docs.patchmypc.com/patch-my-pc-cloud/managed-service-provider-feature/msp-custom-apps) to an App Set, provided that app has been created and assigned to all customers.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FOL9id5nfBM9QOOoSx1Xx%2Fimage.png?alt=media&#x26;token=9a5ba9ca-64c6-434b-914e-2df0a0d8392d" alt="Clicking “Add Application” to add an application to this App Set" width="563"><figcaption></figcaption></figure>

6. On the **General Information** page, select the relevant app you want to add from the **Select Application** dropdown or start typing its name.

{% hint style="info" %}
**Note**

Only apps that have been deployed successfully will appear in the **Select Application** dropdown.

An MSP Custom App will only appear in the **Select Application** dropdown if it has been added and assigned to all customers. If the Custom App has only been assigned to a specific customer or only to the MSP, it will not appear in the dropdown.

Also, if an app has multiple variants with different version numbers, you will see a yellow triangle with an exclamation mark next to the **Version** number. This is a warning to you to double-check that you are deploying the correct version.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FrvGRYOF5VreiVl5xb1Su%2Fimage.png?alt=media&#x26;token=a7019660-68f1-47f0-81e4-dbe7f3ceead8" alt="Selecting the relevant app you want to add from the “Select Application” dropdown" width="506"><figcaption></figcaption></figure>

7. In the **Display Name** field, we suggest you add the name of the App Set as a suffix.<br>

   For example, if the App Set’s name is **Core Apps** and you are deploying Adobe Acrobat Pro, we recommend changing the **Display Name** from just **Adobe Acrobat Pro** to **Adobe Acrobat Pro – Core Apps**.

{% hint style="info" %}
**Note**

The reason for the above recommendations is that by default, when an app in an App Set is deployed, if the app has already been deployed in your company, we automatically add the **\_AppSet<*****number*****>** suffix (for example **\_AppSet7**) to the deployment’s name, where **<*****number*****>** is the next available sequential number. This is because all deployment names need to be unique.

So in our Acrobat example, the default deployment name would be something like:

**Adobe Acrobat Pro\_AppSet7**

This is potentially confusing as you won’t know which deployment belongs to which App Set. We are working on improving this.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Flkvq1O32XvHCN29GPwZO%2Fimage.png?alt=media&#x26;token=f75b7b21-575b-44f7-ba5f-70e598c66ced" alt="Modifying the “Display Name” to include the App Set’s suffix" width="509"><figcaption></figcaption></figure>

8. Modify any other settings on the **General Information** page as required, then click **Next**

{% hint style="info" %}
**Note**

In the current release, this page contains a subset of the options for creating a regular PMPC Cloud Deployment. See [General Information (Deployments)](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/deploy-app/general-information-tab) for more details on each option.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FfjuaGmGCh9WD6lS4at9H%2Fimage.png?alt=media&#x26;token=098ea8d0-9a32-439a-a801-f4dc472e1398" alt="Clicking “Next” on the “General information” page." width="509"><figcaption></figcaption></figure>

9. On the **Configurations** page, configure the required options, then click **Next**.

{% hint style="info" %}
**Note**

In the current release, this page contains a subset of the options for creating a regular PMPC Cloud Deployment. See [Configurations (Deployments)](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/deploy-app/configurations-tab) for more details on each option.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FjOq74oAcHPQC9panCivA%2Fimage.png?alt=media&#x26;token=3077844b-2488-408c-a7f6-e12eddb72e4a" alt="Configuring any required options on the “Configurations” page" width="507"><figcaption></figcaption></figure>

10. On the **Assignment Type** page, select which assignment type(s) you want to apply to this App Set, then click **Save** to save your changes.

{% hint style="info" %}
**Note**

As this is an App Set, only certain assignment types are supported compared to a regular PMPC Cloud Deployment. See [Assignments (Deployments)](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/deploy-app/assignments-tab) for more details on each option.

Selecting the **Update Only** type (if available) will create an Update Only app in Intune alongside the Available or Required type selected.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Fgde2L8aKaRNQmj5ble3H%2Fimage.png?alt=media&#x26;token=b08ee1a9-f8bc-4bc2-82fc-cb7070004603" alt="Selecting the assignment type for this app and clicking “Save”" width="502"><figcaption></figcaption></figure>

11. Repeat steps 5 to 10 to add any additional apps to the App Set.

### Deploying the App Set

Once you have finished adding the required apps to an App Set, you can deploy it.

To define where to deploy an App Set:

1. Click the **Assignments** tab.<br>

   <figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FabqBr1ovzEqNN17UQy7V%2Fimage.png?alt=media&#x26;token=31d87fa0-2c58-419e-a81c-7ac04e9754fd" alt="Clicking the “Assignments” tab" width="563"><figcaption></figcaption></figure>
2. If you don’t want to use Update Rings, go to step 4.
3. Click **Enable Update Rings** and [configure them](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/update-rings/create) as required.

{% hint style="info" %}
**Note**

In App Sets, we only support [Immediate ](https://docs.patchmypc.com/installation-guides/patch-my-pc-cloud/deployments/update-rings/how-update-rings-are-created#immediate-update-rings)Update Rings.

You can add multiple companies to an App Set and to the same set of Update Rings.

A child customer also doesn’t need to be present in all rings. For example, if you create four Update Rings for an App Set, but a child customer only requires two rings, you only need to add that child customer to the two relevant rings. On the child customer side, only the rings they are part of will be created in the child company, not all four rings defined in the App Set.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FeasnVHdpAW5HvLlBFDXk%2Fimage.png?alt=media&#x26;token=bd730053-0e31-4bb7-a986-475b3753ca5f" alt="Clicking “Enable Update Rings”" width="563"><figcaption></figcaption></figure>

4. Click **Add Assignment**\ <br>

   <figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FUjmg57Yxn01GsKDDkz01%2Fimage.png?alt=media&#x26;token=e47ff7be-3cfb-48c3-9588-f7c8add338ea" alt="Clicking “Add Assignment”" width="563"><figcaption></figcaption></figure>
5. Select the relevant company that has an Intune connection that you want to assign this deployment to and click **Next**

{% hint style="info" %}
**Note**

You can only select a single company at a time (up to a maximum of 100), as every company’s Entra ID setup in terms of resources will be different.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F0fqtc4CEBe97KWLj6MM1%2Fimage.png?alt=media&#x26;token=0c79d3eb-7641-4645-bbbc-86dcaa6a145c" alt="Selecting the relevant company to assign this deployment to." width="466"><figcaption></figcaption></figure>

6. On the **Assignments** tab, select the relevant resources you want to deploy this app to and click **Save**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FZt4I8l80kKxcUcGXrYt4%2Fimage.png?alt=media&#x26;token=013e279e-17db-4b3e-8eda-4147059149e5" alt="Selecting the relevant resources for this assignment" width="460"><figcaption></figcaption></figure>

7. Repeat steps 4 to 6 to add any additional companies you want to deploy this App Set to.
8. On the **App Set** page, configure any required settings for the assignments.

{% hint style="success" %}
**Tip**

If you are using Update Rings for this App Set, we recommend you create all of the assignments first, which adds all of them to the first Update Ring. Then drag and drop the assignments to the relevant rings.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Fnkq1Z1JtpRGLiGbWIXfk%2Fimage.png?alt=media&#x26;token=593791bf-7ba7-4f25-8a42-7c0dc8698433" alt="Configuring any required settings for the assignments" width="563"><figcaption></figcaption></figure>

9. Click **Deploy** to deploy this App Set.<br>

   <figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FF521RdavTNpCBd3Atf51%2Fimage.png?alt=media&#x26;token=0d003e07-18b2-4846-b7c9-15bf02bbd700" alt="Clicking “Deploy” to deploy this App Set" width="563"><figcaption></figcaption></figure>

The **App Sets** page is redisplayed along with the **Success – App Set created** notification. The newly created App Set will show a Status of **In Progress**, followed by **Success** once all the deployments within the App Set have been completed successfully.

{% hint style="info" %}
**Note**

The **Status** will show as **Failed** if one or more of the deployments fails.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FJEejfq3ZO51XTpCMCPmw%2Fimage.png?alt=media&#x26;token=c86d888f-f132-45b7-b5a9-7a0c8bb15e74" alt="“App Sets” showing the newly created deployment" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
**Tip**

You and the admins at the child company can monitor the status of each individual deployment from the **Deployments** node of the targeted company.

![App Set deployment when viewed from the child company](https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FClAD4dy5A7pMMXkPoCY9%2Fimage.png?alt=media\&token=f0f01ea4-5cf3-49c0-8e75-1050aaef6022)
{% endhint %}

{% hint style="danger" %}
**Important**

You cannot **Edit** or **Delete** a deployment from the **Deployments** node if it belongs to an App Set (these options are unavailable when clicking on the ellipsis (**⋮**) beside the deployment). This is another reason for adding the App Set’s name as a suffix to the app’s **Display Name** so that when you are viewing all of your deployments, you and the admins at your child companies can easily identify which deployment belongs to an App Set.
{% endhint %}

Once the App Set has been deployed successfully, it will show a **Status** of **Success** on the **App Sets** page.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FbRjYYi7uRAQtMsDYp5m6%2Fimage.png?alt=media&#x26;token=c40566ff-cd86-41d2-8eb8-3465fe395973" alt="App Set showing with a status of “Success”" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

Once successfully created, any deployments created as part of an App Set will be updated based on the Sync Schedule configured at each child customer. So even if you have a single App Set with deployments to multiple child customers, you can end up with different versions of the same app at different child customers depending on when the [Sync Schedule](https://docs.patchmypc.com/patch-my-pc-cloud/manage/manage-settings/manage-the-sync-schedule-in-cloud) runs. See [Manage Updates](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/manage-deployments/updates) for more information.
{% endhint %}
