> ## 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.

# Distribuire l'agente

> Installa l'agente software Myrmex dal flusso Download Agent nella console: genera un token di installazione, esegui l'installer per il tuo sistema operativo su Windows, macOS o Linux, quindi autorizza il dispositivo.

Installi l'**agente software** Myrmex dalla pagina **Download Agent** nella console. Il flusso è lo stesso su ogni piattaforma: ottieni un token di installazione, esegui l'installer per il tuo sistema operativo, quindi autorizza il nuovo dispositivo.

<Note>
  Questo installa l'**agente software** su un host. Una volta autorizzato, gli
  [agenti IA](/it/documentation/multi-agent-system/overview) possono leggerne la telemetria
  e agire sull'host.
</Note>

## Ottenere un token di installazione

Ogni installazione richiede un **token di installazione**, che la console genera per te:

<Steps>
  <Step title="Apri Download Agent">
    Apri la pagina **Download Agent** dalla console.
  </Step>

  <Step title="Genera un token">
    Genera un token di installazione. È valido per **24 ore** ed è
    **riutilizzabile** entro quella finestra, così un singolo token può effettuare l'onboarding di molti host.
  </Step>

  <Step title="Scegli il tuo SO">
    Scegli Windows, macOS o Linux per ottenere l'installer corrispondente e un
    comando pronto all'uso con il token già incorporato.
  </Step>
</Steps>

<Tip>
  Copia il comando esatto dalla pagina Download Agent — include già il tuo
  token. I comandi seguenti mostrano la forma generale; il segnaposto
  `YOUR_TOKEN` sostituisce quello che la console genera.
</Tip>

## Windows

**Requisiti:** Windows 10 o versioni successive, oppure Windows Server 2016 o versioni successive. Installa come **Administrator** locale.

Scegli uno dei due metodi:

* **Pacchetto MSI** — scarica l'MSI dalla pagina Download Agent ed eseguilo. Approva il prompt del Controllo dell'account utente e segui la procedura guidata fino alla fine.
* **One-liner PowerShell** — esegui il comando dalla console in una sessione PowerShell con privilegi elevati:

```powershell theme={null}
# Esegui in una sessione PowerShell con privilegi elevati (forma mostrata; copia il comando esatto dalla console)
msiexec /i MyrmexAgent.msi INSTALLATION_TOKEN=YOUR_TOKEN /qn
```

L'agente si installa come servizio di sistema e si avvia automaticamente.

## macOS

**Requisiti:** una versione supportata di macOS su **Apple Silicon (arm64)**.

Scegli uno dei due metodi:

* **Installer .pkg** — scarica il `.pkg` dalla pagina Download Agent ed eseguilo, seguendo i prompt.
* **One-liner Bash** — esegui il comando dalla console in Terminale:

```bash theme={null}
# Forma mostrata; copia il comando esatto dalla console
sudo INSTALLATION_TOKEN=YOUR_TOKEN bash -c "$(curl -fsSL <installer-url>)"
```

## Linux

**Requisiti:** una distribuzione supportata — Debian, Ubuntu, Fedora, RHEL, CentOS, Oracle Linux o Amazon Linux. Installa come **root** (o con `sudo`).

Linux usa un unico **installer universale** che esegui con `curl | bash`, passando il tuo token come variabile d'ambiente:

```bash theme={null}
# Forma mostrata; copia il comando esatto dalla console
curl -fsSL <installer-url> | sudo INSTALLATION_TOKEN=YOUR_TOKEN bash
```

L'installer rileva la tua distribuzione, installa l'agente e lo registra come servizio.

<Note>
  Durante l'installazione l'host scarica pacchetti di dipendenze, quindi consenti il traffico in uscita sulla
  **443** verso `*.myrmex.ai` e verso i repository ufficiali della tua distribuzione. Consulta
  [Modalità Collector](/it/documentation/agent-endpoint-security/collector-mode#communication-architecture)
  per il modello di rete completo.
</Note>

## Autorizzare il dispositivo

<Warning>
  Un dispositivo appena installato appare come **unauthorized** e non invia nulla finché
  non lo approvi. Questo passaggio è obbligatorio.
</Warning>

Apri il nuovo dispositivo dalla [vista Endpoints](/it/documentation/agent-endpoint-security/endpoints-view) o dalla sua [vista di dettaglio](/it/documentation/agent-endpoint-security/device-details) e scegli **Authorize**. Il dispositivo si attiva e inizia a inviare dati, e puoi quindi impostarne il ruolo, le regole e altro ancora.

## Migrare un Host tra Contesti

Un **contesto** è l'organizzazione / tenant a cui un host invia i dati. Per spostare un host già installato da un contesto a un altro non disinstalli nulla — **riesegui l'installer con il token del nuovo contesto**, e l'agente si ri-registra da solo.

<Steps>
  <Step title="Ottieni il comando di installazione del nuovo contesto">
    Passa al **contesto di destinazione** e apri la sua pagina **Download Agent**. Genera lì un token di installazione e copia il comando pronto all'uso — è limitato a quel contesto.
  </Step>

  <Step title="Eseguilo sull'host">
    Esegui quel comando esatto sull'host come root / amministratore — lo stesso comando di un'installazione nuova. L'agente si ri-registra nel nuovo contesto: ottiene una nuova identità, riscrive `config.yml` / `env.conf` per puntare al nuovo contesto e si riconnette. Non serve disinstallare né riavviare.
  </Step>

  <Step title="Autorizzalo nel nuovo contesto">
    L'host appare nella [vista Endpoints](/it/documentation/agent-endpoint-security/endpoints-view) del nuovo contesto come **unauthorized**. Approvalo lì per riattivare la telemetria e la risposta. Nel vecchio contesto smette di inviare dati e può essere rimosso.
  </Step>
</Steps>

<Warning>
  **Nessuna integrazione viene migrata con questa operazione.** Le integrazioni appartengono al contesto — vivono nella piattaforma, non sull'host — quindi ri-registrare un host sposta solo l'agente di quell'host. Non copia, sposta né elimina alcuna integrazione: il vecchio contesto mantiene le sue integrazioni e il nuovo usa ciò che vi è configurato.
</Warning>

<Note>
  Rieseguire l'installer si limita a sovrascrivere il collegamento di contesto dell'host (`config.yml` / `env.conf`) con quello del nuovo contesto — è tutta qui la migrazione. Il binario dell'agente e i suoi servizi restano al loro posto.
</Note>

## Dove andare dopo

<CardGroup cols={2}>
  <Card title="Dettagli e azioni del dispositivo" icon="desktop" href="/it/documentation/agent-endpoint-security/device-details">
    Autorizza, imposta il ruolo ed esegui azioni sull'host.
  </Card>

  <Card title="Endpoint vs Collector" icon="arrows-left-right" href="/it/documentation/agent-endpoint-security/endpoint-mode">
    Scegli come funziona il dispositivo dopo l'installazione.
  </Card>

  <Card title="Comunicazione dell'agente" icon="lock" href="/it/documentation/agent-endpoint-security/communication">
    Come funzionano l'enrollment e il token sotto il cofano.
  </Card>

  <Card title="Capacità dell'agente" icon="list-check" href="/it/documentation/agent-endpoint-security/features">
    Cosa fa l'agente una volta attivo.
  </Card>
</CardGroup>