Instalar y desplegar el agente
Qué hace el agente
El agente de Ubidesk es el componente que se instala en las máquinas que administras de forma permanente. Una vez desplegado:
- mantiene la conexión con el espacio de trabajo y se reconecta solo tras un reinicio, una caída de red o un cambio de red;
- sigue accesible cuando Windows arranca en modo seguro con funciones de red;
- responde a las solicitudes de Wake-on-LAN enviadas desde la consola.
El agente no es necesario para las sesiones asistidas: los usuarios puntuales usan un cliente temporal sin instalación. Sí es imprescindible para el acceso desatendido: ese modo se apoya por completo en el agente instalado.
Elige el formato de paquete adecuado
Hay cuatro paquetes disponibles, uno por plataforma:
| Plataforma | Formato | Despliegue masivo |
|---|---|---|
| Windows | MSI | GPO, Intune |
| macOS | PKG | Jamf |
| Debian / Ubuntu | DEB | gestor de paquetes |
| RHEL / Fedora / SUSE | RPM | gestor de paquetes |
Descarga el paquete correspondiente desde tu espacio de trabajo. Cada paquete lleva integrada la vinculación con tu cuenta, así que el mismo paquete sirve para todo el parque: no necesitas generar un instalador por máquina.
Instalar en Windows
La instalación interactiva es un doble clic sobre el MSI. Para un despliegue silencioso, ejecuta desde una consola con permisos elevados:
msiexec /i ubidesk-agent.msi /qnEl agente se registra como servicio de Windows, que arranca automáticamente en cada inicio del sistema.
Instalar en macOS
Abre el PKG y sigue el asistente. Para un despliegue silencioso:
sudo installer -pkg ubidesk-agent.pkg -target /El agente instala un daemon que se lanza al iniciar sesión.
Instalar en Linux
En Debian o Ubuntu:
sudo apt install ./ubidesk-agent.debEn RHEL, Fedora o SUSE:
sudo dnf install ./ubidesk-agent.rpmEl agente se registra como servicio de systemd y se reinicia con la máquina.
Desplegar a escala
- GPO (Windows): asigna el MSI como instalación por equipo en una GPO del dominio. Se aplica en el arranque, sin permisos de administrador local.
- Intune: publica el MSI como aplicación de línea de negocio, dirígete a un grupo de dispositivos y sigue el estado del despliegue en el centro de administración.
- Jamf (macOS): importa el PKG en Jamf Pro, crea una política de instalación y asígnala a un grupo estático o dinámico.
Con cualquiera de las tres vías, el objetivo es el mismo: que el paquete llegue a cada máquina sin intervención manual delante del equipo.
Requisitos de red y cortafuegos
El agente solo necesita HTTPS saliente, en el puerto 443. No hay que abrir puertos de entrada en la máquina de destino y no hace falta una VPN. Si tu entorno obliga a pasar por un proxy, comprueba que permite HTTPS hacia la infraestructura de Ubidesk; todo lo demás usa el mismo canal TLS 1.3 que la consola.
Verifica la instalación
- En la consola, abre la lista de dispositivos: la máquina aparece a los pocos segundos de la instalación.
- Reinicia la máquina y confirma que el dispositivo vuelve a estar en línea por sí solo.
- En Windows, prueba un reinicio en modo seguro con funciones de red: el dispositivo debe seguir accesible.
Los tres pasos confirman lo esencial: que el agente está instalado, que sobrevive a un reinicio y que sigue disponible en modo seguro.
Las máquinas apagadas o en suspensión se pueden encender con Wake-on-LAN si el hardware y la BIOS lo permiten. Ver Acceso desatendido: configuración.
Desinstalar
En Windows, desinstala desde el panel de aplicaciones o desde la línea de comandos:
msiexec /x ubidesk-agent.msi /qnEn macOS, elimina el paquete desde la carpeta de aplicaciones o mediante Jamf. En Linux, usa el gestor de paquetes (apt remove o dnf remove). Tras la desinstalación, el dispositivo desaparece de la lista de dispositivos del espacio en la siguiente sincronización.