> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/entreprise/deployer-le-pkg-de-shade-dans-jamf-pro.md).

# Déployer le PKG de Shade dans Jamf Pro

{% hint style="info" %}
Pour la documentation la plus récente, veuillez consulter [la documentation PKG de Jamf Pro](https://learn.jamf.com/r/en-US/jamf-pro-documentation-current/Viewing_the_Contents_of_an_Indexed_Package)
{% endhint %}

#### Prérequis

* Accès à Jamf Pro avec les autorisations pour téléverser des paquets (généralement **Administrateur du serveur Jamf Pro** ou un rôle pouvant gérer les paquets).
* Un Mac avec un navigateur capable de télécharger l’installateur.
  * Si vous téléchargez l’application macOS, Shade recommande d’utiliser un navigateur autre que Safari.

#### 1) Téléchargez le PKG de Shade

1. Ouvrir : <https://shade.inc/download>
2. Sous **Télécharger Shade**, choisissez la bonne version pour votre Mac :
   * **macOS (Apple Silicon)** pour les Mac de la série M (M1, M2, M3, M4)
   * **macOS (Intel)** pour les Mac Intel
3. Téléchargez le fichier d’installation.
4. Confirmez que le téléchargement est terminé et que vous avez un seul fichier d’installation à téléverser (par exemple, dans **Téléchargements**).

#### 2) (Recommandé) Validez le paquet avant le téléversement

1. Vérifiez que vous avez téléchargé la bonne architecture (Apple Silicon ou Intel).
2. Assurez-vous que le fichier :
   * s’ouvre ou s’installe correctement sur une machine de test.
   * a une taille de fichier raisonnable (pas anormalement petite).
3. Renommez le fichier avec un nom clair et versionné (recommandé), par exemple :
   * `Shade-Desktop-<version>.pkg`

#### 3) Téléversez le PKG dans Jamf Pro

1. Connectez-vous à **Jamf Pro**.
2. Accédez à **Réglages**.
3. Naviguez jusqu’à la section **Paquets** (parfois répertoriée sous **Gestion des ordinateurs** selon votre version de Jamf Pro).
4. Cliquez sur **Nouveau** ou **Téléverser** (l’intitulé varie selon la version de Jamf Pro).
5. Dans le formulaire de téléversement, sélectionnez le PKG Shade que vous avez téléchargé.
6. Configurez les **réglages du paquet** (options courantes) :
   * **Nom d’affichage** : utilisez un nom clair (par exemple, `Shade`).
   * **Catégorie** : facultatif, mais utile pour l’organisation (par exemple, `Applications`).
   * **Priorité** : conservez la valeur par défaut sauf si vous avez plusieurs paquets dépendants.
   * **Exigences du système d’exploitation** : définissez la version minimale de macOS si votre environnement l’exige.
   * **Architecture** : si Jamf permet de la préciser, faites correspondre le paquet téléchargé (Apple Silicon ou Intel).
7. Enregistrez.
8. Attendez la fin du téléversement, puis confirmez que le paquet apparaît dans la **Paquets** liste.

#### 4) Confirmez que le paquet est disponible pour le déploiement

1. Ouvrez le paquet téléversé dans Jamf Pro.
2. Confirmez :
   * Le nom et les détails du paquet semblent corrects.
   * Le paquet est indiqué comme téléversé avec succès (aucune erreur).

#### 5) Étapes suivantes (facultatif) : déployer sur les appareils

Une fois le PKG téléversé, vous pouvez le déployer à l’aide de l’une de ces approches :

* **Politique** : installez Shade à la demande (Self Service) ou automatiquement (vérification récurrente, inscription).
* **Inscription PreStage** : installez pendant les workflows d’inscription.

#### Déployer via Self Service (à la demande)

Utilisez cette méthode si vous souhaitez que Shade soit disponible dans l’application Jamf Self Service, permettant aux utilisateurs de choisir quand l’installer.

1. **Créer une nouvelle politique** : dans Jamf Pro, allez à **Ordinateurs** > **Policies** et cliquez sur **Nouveau**.
2. **Charge utile générale**:
   * **Nom d’affichage**: `Installer Shade`
   * **Déclencheur** : aucun (les politiques Self Service ne nécessitent pas de déclencheur système).
   * **Fréquence d’exécution**: `Continue`  (cela permet aux utilisateurs de réinstaller l’application s’ils passent à une nouvelle machine ou la suppriment accidentellement).
3. **Charge utile des paquets**:
   * Cliquez sur **Configurez** et trouvez votre PKG Shade téléversé.
   * Assurez-vous que l’action est définie sur **Installer**.
4. **Charge utile Self Service**:
   * Cliquez sur l’onglet **Self Service** en haut.
   * Cochez la case **Rendre la politique disponible dans Self Service**.
   * **Nom d’affichage Self Service**: `Shade`
   * **Nom du bouton**: `Installer`
   * **Description** : fournissez une brève description (par ex., "Shade est votre gestionnaire de ressources créatives...").
   * **Icône** : téléversez l’icône de l’application Shade pour un rendu professionnel.
5. **Portée**:
   * Cliquez sur l’onglet **Portée** onglet.
   * Ajoutez les ordinateurs spécifiques ou les groupes intelligents (par ex. « All Managed Clients ») qui doivent voir Shade dans leur catalogue Self Service.
6. **Enregistrer**.

***

#### Déployer via une installation silencieuse (automatique)

Utilisez cette méthode si vous souhaitez que Shade soit installé automatiquement en arrière-plan sur les Mac, sans aucune interaction utilisateur.

1. **Créer une nouvelle politique** : dans Jamf Pro, allez à **Ordinateurs** > **Policies** et cliquez sur **Nouveau**.
2. **Charge utile générale**:
   * **Nom d’affichage**: `Déployer Shade - Automatique`
   * **Déclencheur** : sélectionnez **Vérification récurrente**  (il s’agit du déclencheur standard pour les déploiements silencieux en arrière-plan).
   * **Fréquence d’exécution** : sélectionnez **Une fois par ordinateur**.
3. **Charge utile des paquets**:
   * Cliquez sur **Configurez** et trouvez votre PKG Shade téléversé.
   * Assurez-vous que l’action est définie sur **Installer**.
4. **Charge utile de maintenance**:
   * Cliquez sur **Configurez** et cochez la case **Mettre à jour l’inventaire** Cette option garantit que Jamf sait que l’application est installée immédiatement après l’exécution de la politique.
5. **Portée**:
   * Cliquez sur l’onglet **Portée** onglet.
   * Ajoutez les ordinateurs ou les groupes intelligents qui nécessitent Shade.
   * *Conseil : utilisez un groupe intelligent qui cible les ordinateurs sur lesquels « Shade.app » n’est actuellement pas installé.*
6. **Enregistrer**.

***

#### Vérifier le déploiement

Après avoir enregistré votre politique, vous pouvez suivre sa progression :

* **Journaux** : ouvrez la politique dans Jamf Pro et cliquez sur le **Journaux** bouton en bas à droite. Cela vous montrera quels ordinateurs ont correctement installé le paquet et lesquels sont encore en attente.
* **Inventaire** : vérifiez le dossier d’inventaire d’un ordinateur individuel sous **Applications** pour confirmer que `Shade.app` apparaît dans la liste.

#### Conseils de dépannage

* **Incompatibilité d’architecture** : si une installation silencieuse échoue, vérifiez que vous n’avez pas déployé un PKG Intel sur un Mac Apple Silicon (M1/M2/M3).
* **FileVault** : si vous déployez pendant l’inscription (PreStage), assurez-vous que les options "Fill User Template" ou "At Restart" ne sont PAS sélectionnées, car Shade doit être installé dans le `/Applications` dossier normalement.


---

# 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://academy.shade.inc/shade-academy/shade-academy-fr/entreprise/deployer-le-pkg-de-shade-dans-jamf-pro.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.