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

# Implementar el PKG de Shade en Jamf Pro

Esta guía explica cómo descargar el paquete instalador de Shade (PKG) y subirlo a Jamf Pro para que pueda implementarse en Mac.

{% hint style="info" %}
Para la documentación más reciente, consulte [la documentación PKG de Jamf Pro](https://learn.jamf.com/r/en-US/jamf-pro-documentation-current/Viewing_the_Contents_of_an_Indexed_Package)
{% endhint %}

#### Requisitos previos

* Acceso a Jamf Pro con permisos para cargar paquetes (normalmente **Administrador del servidor de Jamf Pro** o un rol que pueda administrar Paquetes).
* Un Mac con un navegador que pueda descargar el instalador.
  * Si está descargando la app para macOS, Shade recomienda usar un navegador distinto de Safari.

#### 1) Descargue el PKG de Shade

1. Abra: <https://shade.inc/download>
2. En **Descargar Shade**, elija la compilación correcta para su Mac:
   * **macOS (Apple Silicon)** para Macs de la serie M (M1, M2, M3, M4)
   * **macOS (Intel)** para Macs Intel
3. Descargue el archivo del instalador.
4. Confirme que la descarga se completó y que tiene un único archivo de instalador para cargar (por ejemplo, en **Descargas**).

#### 2) (Recomendado) Valide el paquete antes de cargarlo

1. Verifique que descargó la arquitectura correcta (Apple Silicon frente a Intel).
2. Asegúrese de que el archivo:
   * Se abre o se instala correctamente en una máquina de prueba.
   * Tiene un tamaño de archivo razonable (no sospechosamente pequeño).
3. Cambie el nombre del archivo por uno claro y con versión (recomendado), por ejemplo:
   * `Shade-Desktop-<versión>.pkg`

#### 3) Cargue el PKG en Jamf Pro

1. Inicie sesión en **Jamf Pro**.
2. Vaya a **Configuración**.
3. Navegue a la sección **Paquetes** (a veces aparece en **Administración de equipos** según la versión de Jamf Pro que tenga).
4. Haz clic en **Nuevo** o **Subir** (la etiqueta varía según la versión de Jamf Pro).
5. En el formulario de carga, seleccione el PKG de Shade que descargó.
6. Configure **Ajustes del paquete** (opciones comunes):
   * **Nombre para mostrar**: Use un nombre claro (por ejemplo, `Shade`).
   * **Categoría**: Opcional, pero útil para la organización (por ejemplo, `Aplicaciones`).
   * **Prioridad**: Mantenga el valor predeterminado a menos que tenga varios paquetes dependientes.
   * **Requisitos del sistema operativo**: Establezca la versión mínima de macOS si su entorno lo requiere.
   * **Arquitectura**: Si Jamf permite especificarla, haga coincidir el paquete que descargó (Apple Silicon frente a Intel).
7. Guarde.
8. Espere a que termine la carga y luego confirme que el paquete aparece en la **Paquetes** lista.

#### 4) Confirme que el paquete esté disponible para su implementación

1. Abra el paquete cargado en Jamf Pro.
2. Confirme:
   * El nombre y los detalles del paquete se ven correctos.
   * El paquete se muestra como cargado correctamente (sin errores).

#### 5) Siguientes pasos (opcional): Implementar en dispositivos

Después de cargar el PKG, puede implementarlo usando uno de estos enfoques:

* **Política**: Instale Shade bajo demanda (Self Service) o automáticamente (check-in recurrente, inscripción).
* **Inscripción PreStage**: Instale durante los flujos de trabajo de inscripción.

#### Implementar mediante Self Service (bajo demanda)

Use este método si desea que Shade esté disponible en la app Jamf Self Service, permitiendo que los usuarios elijan cuándo instalarlo.

1. **Crear una nueva política**: En Jamf Pro, vaya a **Equipos** > **Políticas** y haz clic en **Nuevo**.
2. **Carga útil general**:
   * **Nombre para mostrar**: `Instalar Shade`
   * **Activador**: Ninguno (las políticas de Self Service no requieren un activador del sistema).
   * **Frecuencia de ejecución**: `Continua` (esto permite a los usuarios reinstalar la app si cambian a una nueva máquina o la eliminan accidentalmente).
3. **Carga útil de paquetes**:
   * Haz clic en **Configure** y encuentre su PKG de Shade cargado.
   * Asegúrese de que la acción esté configurada en **Instalar**.
4. **Carga útil de Self Service**:
   * Haga clic en la pestaña **Self Service** en la parte superior.
   * Marque la casilla **Hacer que la política esté disponible en Self Service**.
   * **Nombre para mostrar en Self Service**: `Shade`
   * **Nombre del botón**: `Instalar`
   * **Descripción**: Proporcione una breve descripción (p. ej., "Shade es su administrador de activos creativos...").
   * **Icono**: Cargue el icono de la aplicación Shade para un aspecto profesional.
5. **Ámbito**:
   * Haga clic en la pestaña **Ámbito** pestaña.
   * Añada los equipos específicos o Grupos inteligentes (p. ej., "Todos los clientes administrados") que deberían ver Shade en su catálogo de Self Service.
6. **Guardar**.

***

#### Implementar mediante instalación silenciosa (automática)

Use este método si desea que Shade se instale automáticamente en Macs en segundo plano sin ninguna interacción del usuario.

1. **Crear una nueva política**: En Jamf Pro, vaya a **Equipos** > **Políticas** y haz clic en **Nuevo**.
2. **Carga útil general**:
   * **Nombre para mostrar**: `Implementar Shade - Automático`
   * **Activador**: Seleccione **Check-in recurrente** (este es el activador estándar para implementaciones silenciosas en segundo plano).
   * **Frecuencia de ejecución**: Seleccione **Una vez por equipo**.
3. **Carga útil de paquetes**:
   * Haz clic en **Configure** y encuentre su PKG de Shade cargado.
   * Asegúrese de que la acción esté configurada en **Instalar**.
4. **Carga útil de mantenimiento**:
   * Haz clic en **Configure** y marque la casilla **Actualizar inventario** Esto garantiza que Jamf sepa de inmediato que la app está instalada después de que se ejecute la política.
5. **Ámbito**:
   * Haga clic en la pestaña **Ámbito** pestaña.
   * Añada los equipos o Grupos inteligentes que requieran Shade.
   * *Consejo: Use un Grupo inteligente que dirija los equipos donde actualmente no está instalada "Shade.app".*
6. **Guardar**.

***

#### Verificar la implementación

Después de guardar su política, puede supervisar su progreso:

* **Registros**: Abra la política en Jamf Pro y haga clic en el **Registros** botón en la parte inferior derecha. Esto le mostrará qué equipos han instalado correctamente el paquete y cuáles siguen pendientes.
* **Inventario**: Compruebe el registro de inventario de un equipo individual en **Aplicaciones** para confirmar `Shade.app` aparece en la lista.

#### Qué hace el PKG de Shade durante la instalación

El PKG ejecuta un script posterior a la instalación con privilegios de administrador. Los administradores de TI deben saber que:

* Cierra cualquier proceso de Shade en ejecución antes de instalar.
* Establece los permisos del asistente ShadeFS dentro de la app Shade (propiedad de root con el bit setuid), que ShadeFS necesita para montar unidades.
* Añade una entrada `fuse-t` que apunta a la máquina local (127.0.0.1) en el archivo hosts de macOS, si aún no está allí. El backend de montaje FUSE-T integrado requiere esta entrada.
* Descarga el servicio XPC de ShadeFS desde `storage.googleapis.com` y lo registra como un LaunchAgent (`inc.shade.xpc`) para el usuario que ha iniciado sesión. **Esto requiere acceso a la red en el momento de la instalación.** Si la descarga falla, la instalación aún se completa, pero la extensión Shade Finder no funcionará.
* Registra y habilita la extensión Shade Finder.
* Elimina cualquier copia del panel de Shade para Premiere Pro instalado por PKG anteriores. El panel ahora se distribuye a través de Adobe Exchange.

#### Actualización de Shade en Macs administrados

En macOS, las actualizaciones dentro de la app descargan un nuevo PKG y lo abren en el Instalador de macOS, por lo que la persona que instala la actualización necesita privilegios de administrador. Si sus usuarios no tienen privilegios de administrador, planifique implementar nuevas versiones de Shade mediante Jamf.

#### Consejos de solución de problemas

* **Incompatibilidad de arquitectura**: Si falla una instalación silenciosa, verifique que no haya implementado un PKG Intel en un Mac Apple Silicon (M1/M2/M3).
* **FileVault**: Si está implementando durante la inscripción (PreStage), asegúrese de que las opciones "Fill User Template" o "At Restart" NO estén seleccionadas, ya que Shade debe instalarse en la `/Applications` carpeta normalmente.


---

# 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-es/empresa/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.
