> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Despliegue del agente

> Instala el agente de software de Myrmex desde el flujo Download Agent de la consola: genera un token de instalación, ejecuta el instalador correspondiente a Windows, macOS o Linux y luego autoriza el dispositivo.

Instalas el **agente de software** de Myrmex desde la página **Download Agent** de la consola. El flujo es el mismo en todas las plataformas: obtén un token de instalación, ejecuta el instalador para tu sistema operativo y luego autoriza el nuevo dispositivo.

<Note>
  Esto instala el **agente de software** en un host. Una vez autorizado, los
  [agentes de IA](/es/documentation/multi-agent-system/overview) pueden leer su telemetría
  y actuar sobre el host.
</Note>

## Obtener un token de instalación

Cada instalación necesita un **token de instalación**, que la consola genera por ti:

<Steps>
  <Step title="Abre Download Agent">
    Abre la página **Download Agent** desde la consola.
  </Step>

  <Step title="Genera un token">
    Genera un token de instalación. Es válido durante **24 horas** y es
    **reutilizable** dentro de esa ventana, por lo que un solo token puede incorporar muchos hosts.
  </Step>

  <Step title="Elige tu SO">
    Elige Windows, macOS o Linux para obtener el instalador correspondiente y un
    comando listo para ejecutar con el token ya incorporado.
  </Step>
</Steps>

<Tip>
  Copia el comando exacto de la página Download Agent: ya incluye tu
  token. Los comandos de abajo muestran la forma general; el marcador de posición
  `YOUR_TOKEN` representa el que genera la consola.
</Tip>

## Windows

**Requisitos:** Windows 10 o posterior, o Windows Server 2016 o posterior. Instala como **Administrador** local.

Elige cualquiera de los dos métodos:

* **Paquete MSI**: descarga el MSI desde la página Download Agent y ejecútalo. Aprueba el mensaje de Control de cuentas de usuario y sigue el asistente de configuración hasta el final.
* **Comando de una línea en PowerShell**: ejecuta el comando de la consola en una sesión de PowerShell con privilegios elevados:

```powershell theme={null}
# Run in an elevated PowerShell (shape shown; copy the exact command from the console)
msiexec /i MyrmexAgent.msi INSTALLATION_TOKEN=YOUR_TOKEN /qn
```

El agente se instala como un servicio del sistema y se inicia automáticamente.

## macOS

**Requisitos:** una versión compatible de macOS en **Apple Silicon (arm64)**.

Elige cualquiera de los dos métodos:

* **Instalador .pkg**: descarga el `.pkg` desde la página Download Agent y ejecútalo, siguiendo los mensajes.
* **Comando de una línea en Bash**: ejecuta el comando de la consola en la Terminal:

```bash theme={null}
# Shape shown; copy the exact command from the console
sudo INSTALLATION_TOKEN=YOUR_TOKEN bash -c "$(curl -fsSL <installer-url>)"
```

## Linux

**Requisitos:** una distribución compatible: Debian, Ubuntu, Fedora, RHEL, CentOS, Oracle Linux o Amazon Linux. Instala como **root** (o con `sudo`).

Linux usa un único **instalador universal** que ejecutas con `curl | bash`, pasando tu token como una variable de entorno:

```bash theme={null}
# Shape shown; copy the exact command from the console
curl -fsSL <installer-url> | sudo INSTALLATION_TOKEN=YOUR_TOKEN bash
```

El instalador detecta tu distribución, instala el agente y lo registra como un servicio.

<Note>
  Durante la instalación, el host descarga paquetes de dependencias, así que permite el tráfico saliente
  por el **443** hacia `*.myrmex.ai` y hacia los repositorios oficiales de tu distribución. Consulta
  [Modo Collector](/es/documentation/agent-endpoint-security/collector-mode#communication-architecture)
  para ver el modelo de red completo.
</Note>

## Autorizar el dispositivo

<Warning>
  Un dispositivo recién instalado aparece como **unauthorized** y no reporta nada hasta
  que lo apruebas. Este paso es obligatorio.
</Warning>

Abre el nuevo dispositivo desde la [vista de Endpoints](/es/documentation/agent-endpoint-security/endpoints-view) o su [vista de detalle](/es/documentation/agent-endpoint-security/device-details) y elige **Authorize**. El dispositivo se activa y comienza a reportar, y entonces puedes definir su rol, sus reglas y más.

## Migrar un Host Entre Contextos

Un **contexto** es la organización / tenant a la que reporta un host. Para mover un host ya instalado de un contexto a otro no desinstalas nada — vuelves a **ejecutar el instalador con el token del nuevo contexto**, y el agente se re-registra por sí mismo.

<Steps>
  <Step title="Obtén el comando de instalación del nuevo contexto">
    Cambia al **contexto de destino** y abre su página **Download Agent**. Genera allí un token de instalación y copia el comando listo para ejecutar — está limitado a ese contexto.
  </Step>

  <Step title="Ejecútalo en el host">
    Ejecuta ese comando exacto en el host como root / administrador — el mismo comando que una instalación nueva. El agente se re-registra en el nuevo contexto: obtiene una nueva identidad, reescribe `config.yml` / `env.conf` para apuntar al nuevo contexto y se reconecta. No hace falta desinstalar ni reiniciar.
  </Step>

  <Step title="Autorízalo en el nuevo contexto">
    El host aparece en la [vista de Endpoints](/es/documentation/agent-endpoint-security/endpoints-view) del nuevo contexto como **unauthorized**. Apruébalo allí para reactivar la telemetría y la respuesta. En el contexto anterior deja de reportar y puede eliminarse.
  </Step>
</Steps>

<Warning>
  **Ninguna integración se migra con esto.** Las integraciones pertenecen al contexto — viven en la plataforma, no en el host — así que re-registrar un host solo mueve el agente de ese host. No copia, mueve ni elimina ninguna integración: el contexto anterior conserva sus integraciones y el nuevo usa lo que esté configurado en él.
</Warning>

<Note>
  Volver a ejecutar el instalador simplemente sobrescribe el vínculo de contexto del host (`config.yml` / `env.conf`) con el del nuevo contexto — eso es toda la migración. El binario del agente y sus servicios permanecen en su lugar.
</Note>

## A dónde ir después

<CardGroup cols={2}>
  <Card title="Detalles y acciones del dispositivo" icon="desktop" href="/es/documentation/agent-endpoint-security/device-details">
    Autoriza, define el rol y ejecuta acciones en el host.
  </Card>

  <Card title="Endpoint vs. Collector" icon="arrows-left-right" href="/es/documentation/agent-endpoint-security/endpoint-mode">
    Elige cómo se ejecuta el dispositivo después de la instalación.
  </Card>

  <Card title="Comunicación del agente" icon="lock" href="/es/documentation/agent-endpoint-security/communication">
    Cómo funcionan la incorporación y el token internamente.
  </Card>

  <Card title="Capacidades del agente" icon="list-check" href="/es/documentation/agent-endpoint-security/features">
    Lo que hace el agente una vez que está activo.
  </Card>
</CardGroup>