> 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/deploying-the-shade-pkg-to-jamf-pro.md).

# Déploiement du PKG Shade sur Jamf Pro

Ce guide explique comment télécharger le package d’installation Shade (PKG) et le téléverser dans Jamf Pro afin qu’il puisse être déployé sur des Mac.

{% 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

* Un 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’app macOS, Shade recommande d’utiliser un navigateur autre que Safari.

#### 1) Télécharger 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 série M (M1, M2, M3, M4)
   * **macOS (Intel)** pour les Mac Intel
3. Téléchargez le fichier de l’installateur.
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é) Valider 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éverser le PKG dans Jamf Pro

1. Connectez-vous à **Jamf Pro**.
2. Accédez à **Réglages**.
3. Naviguez vers la section **Paquets** section (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. Configurer les paramètres clés **Paramètres 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.
   * **Configuration requise pour l’OS**: Définissez la version minimale de macOS si votre environnement l’exige.
   * **Architecture**: Si Jamf permet de la préciser, faites correspondre le paquet que vous avez 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) Confirmer 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 s’affiche 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**: Installer Shade à la demande (Self Service) ou automatiquement (vérification récurrente, inscription).
* **Inscription PreStage**: Installer pendant les flux de travail 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** > **Stratégies** 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 le PKG Shade que vous avez téléversé.
   * Assurez-vous que l’action est définie sur **Installer**.
4. **Charge utile Self Service**:
   * Cliquez sur le **Self Service** onglet en haut.
   * Cochez la case **Rendre la politique disponible dans Self Service**.
   * **Nom d’affichage Self Service**: `Shade`
   * **Nom du bouton**: `Installer`
   * **Description**: Indiquez une brève description (par ex., « Shade est votre gestionnaire d’actifs créatifs... »).
   * **Icône**: Téléversez l’icône de l’application Shade pour un rendu professionnel.
5. **Portée**:
   * Cliquez sur le **Portée** onglet.
   * Ajoutez les ordinateurs spécifiques ou les groupes intelligents (par ex., « Tous les clients gérés ») 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** > **Stratégies** 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 le PKG Shade que vous avez 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** Cela 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 le **Portée** onglet.
   * Ajoutez les ordinateurs ou groupes intelligents qui ont besoin de Shade.
   * *Astuce : utilisez un groupe intelligent qui cible les ordinateurs sur lesquels « Shade.app » n’est pas actuellement 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 installé le paquet avec succès et lesquels sont encore en attente.
* **Inventaire**: Vérifiez l’enregistrement d’inventaire d’un ordinateur individuel sous **Applications** pour confirmer `Shade.app` apparaît dans la liste.

#### Ce que fait le PKG de Shade pendant l’installation

Le PKG exécute un script de post-installation avec des privilèges administrateur. Les administrateurs informatiques doivent savoir qu’il :

* Quitte tous les processus Shade en cours avant l’installation.
* Définit les autorisations sur l’assistant ShadeFS à l’intérieur de l’application Shade (propriété de root avec le bit setuid), dont ShadeFS a besoin pour monter les volumes.
* Ajoute une `fuse-t` entrée pointant vers la machine locale (127.0.0.1) dans le fichier hosts de macOS, si elle n’y figure pas déjà. Le backend de montage FUSE-T intégré nécessite cette entrée.
* Télécharge le service XPC ShadeFS depuis `storage.googleapis.com` et l’enregistre en tant que LaunchAgent (`inc.shade.xpc`) pour l’utilisateur connecté. **Cela nécessite un accès réseau au moment de l’installation.** Si le téléchargement échoue, l’installation se termine quand même, mais l’extension Finder de Shade ne fonctionnera pas.
* Enregistre et active l’extension Finder de Shade.
* Supprime toute copie du panneau Shade Premiere Pro installée par d’anciens PKG. Le panneau est désormais distribué via Adobe Exchange.

#### Mise à jour de Shade sur les Mac gérés

Sur macOS, les mises à jour intégrées téléchargent un nouveau PKG et l’ouvrent dans l’installateur macOS, donc la personne qui installe la mise à jour doit disposer des droits administrateur. Si vos utilisateurs n’ont pas de droits administrateur, prévoyez de déployer les nouvelles versions de Shade via Jamf.

#### 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 « Remplir le modèle utilisateur » ou « Au redémarrage » ne sont PAS sélectionnées, car Shade doit être installé normalement dans le `/Applications` dossier.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/entreprise/deploying-the-shade-pkg-to-jamf-pro.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
