# Come mantenere Hermes Agent attivo su un server 24 ore su 24 > Come mantenere Hermes Agent attivo 24/7 su un server: installazione su un VPS senza browser, esecuzione del gateway come servizio di sistema, avvio automatico dopo un riavvio, linger e Docker. Source: https://ailoot.ai/blog/it/hermes-agent-vps-24-7/ Canonical: https://ailoot.ai/blog/it/hermes-agent-vps-24-7/ Language: it Publisher: Ailoot (https://ailoot.ai/) Translation: guide-116 Revision: sha256-6acf11d95cbed5e37ec8675c1455950c3e20c83ea3aea47041bd0cfda76014bc Dopo aver installato Hermes Agent su un portatile, sorge una domanda: chi risponderà su Telegram e preparerà i riepiloghi del mattino quando il portatile è chiuso? Alla scrivania, l'agente vive solo finché il computer è acceso. Per mantenere il bot online tutto il tempo e far sì che le attività pianificate vengano eseguite da sole, devi spostare l'agente su un server. Di seguito vediamo come installare Hermes su un normale server Linux, trasformare il gateway in un servizio sempre attivo che si avvia automaticamente dopo un riavvio e limitare l'accesso per impedire agli estranei di entrare nel terminale. Questa guida si basa sulla documentazione ufficiale. Se non hai ancora installato Hermes, inizia dalla panoramica separata su [che cos'è questo agente e come installarlo](https://ailoot.ai/blog/it/hermes-agent-install-setup/). Questa guida presuppone che tu lo abbia già in funzione sul tuo computer e tratta solo il trasferimento su un server. Le informazioni su come lavorare con Ailoot sono disponibili nella [documentazione](https://ailoot.ai/docs/). ## Perché spostare Hermes Agent da un portatile a un server?
Punti chiave Un computer personale funziona finché sei nei paraggi e resta acceso. Per il funzionamento 24 ore su 24 serve un server: il bot Telegram risponde quando il computer è spento e le attività pianificate vengono eseguite da sole. Ti serve un server solo per questo; per il normale lavoro con l'agente basta un portatile.
Su un portatile, Hermes funziona solo mentre lo schermo è aperto e sei nei paraggi. Chiudilo e il bot tace; il riepilogo del mattino non arriva. Non è adatto a un'attività come «rispondere alle persone in un messenger e occuparsi di alcune cose secondo una pianificazione». È qui che un server fa la differenza: non dorme mai e non dipende da altro. Ci installi lo stesso Hermes e funziona senza di te: risponde su Telegram alle tre del mattino, raccoglie ogni mattina notizie sugli argomenti che ti interessano e conserva le sessioni tra un'esecuzione e l'altra. Spostarlo ha senso quando hai un'attività continuativa per l'agente: un bot per te o per il tuo team, riepiloghi mattutini, risposte automatiche o lavoro regolare con i documenti. Se stai solo provando Hermes per un progetto specifico e sei lì vicino, per ora non ti serve un server: è un passaggio in più. ## Cosa preparare prima di installare Hermes su un VPS?
Punti chiave Ti serve un server Linux con accesso SSH (il team ufficiale testa su una nuova installazione di Ubuntu), un modello scelto in anticipo e la consapevolezza che di solito l'agente non ha bisogno di un browser su un server. Per il funzionamento senza supervisione, il modo più comodo per accedere a un modello è tramite Nous Portal: l'accesso OAuth si rinnova automaticamente, quindi un token scaduto non interromperà il servizio durante la notte.
Prima dell'installazione, prepara tre cose. **Il server.** Va bene un normale VPS Linux. Il supporto di primo livello della documentazione riguarda Linux e WSL2 e i test vengono eseguiti sull'ultima versione di Ubuntu. Se il sistema ha glibc, systemd e una struttura di directory familiare, Hermes si installerà correttamente. Questo è importante su un server perché tutti i passaggi di avvio automatico descritti sotto si basano su systemd, disponibile in Ubuntu e Debian. **Accesso SSH.** Ti colleghi al server tramite un terminale su SSH; lì non userai il mouse. Tutti i comandi seguenti vengono eseguiti in questa sessione SSH. Se fai vibe coding e il terminale non ti è ancora familiare, non preoccuparti: i comandi sono pochi e puoi copiarli per intero. **Un modello scelto.** L'agente non pensa da solo: chiama un modello. Per un server che lavora senza di te, è importante che l'accesso al modello non scada. L'opzione più semplice è un abbonamento Nous Portal tramite `hermes setup --portal`: l'accesso usa OAuth e il token si rinnova automaticamente. Puoi usare anche le tue chiavi API, ma assicurati che ci siano fondi nell'account: un agente senza interfaccia e con saldo vuoto smetterà semplicemente di funzionare. Il modello deve avere una finestra di contesto di almeno 64.000 token, altrimenti Hermes rifiuterà di avviarsi con quel modello. Tutti i modelli cloud presenti nell'elenco soddisfano questo requisito.
Nota La documentazione ufficiale non fornisce cifre precise per scegliere un VPS o indicare le risorse minime, quindi qui non ne riportiamo. In base all'esperienza descritta, basta una macchina modesta per un gateway con un bot e una pianificazione, perché i calcoli pesanti avvengono dal lato del modello. Il server stesso è sottoposto a un carico molto ridotto. L'automazione del browser è la parte più pesante, ma su un server di solito non è necessaria (ne parliamo subito sotto).
## Come installare Hermes Agent su un server con un solo comando?
Punti chiave Collegati al server tramite SSH ed esegui l'installer con il flag che esclude il browser, non necessario su un server: curl -fsSL \| bash -s -- --skip-browser. Poi riavvia la shell del terminale e scegli un modello con hermes setup --portal. Verifica l'installazione con hermes doctor.
Installare Hermes su un server è quasi come farlo su un portatile, con una differenza: di solito lì l'agente non ha bisogno di un browser. L'automazione del browser richiede anche Chromium, che è piuttosto pesante. Per questo si usa il flag `--skip-browser`. 1. ### Collegati al server tramite SSH ```bash ssh root@your-server-address ``` Esegui tutti i comandi seguenti in questa sessione, direttamente sul server. 2. ### Esegui l'installer senza il browser ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser ``` Lo script scarica l'ambiente necessario e installa il comando `hermes`. Il flag `--skip-browser` salta l'installazione dell'automazione del browser; su un server senza interfaccia grafica occuperebbe solo spazio. Se in seguito ti servirà un browser, potrai installarlo separatamente. 3. ### Riavvia la shell e scegli un modello ```bash source ~/.bashrc hermes setup --portal ``` La prima riga aggiorna il nuovo `PATH`, così il comando `hermes` viene trovato. La seconda apre l'accesso a Nous Portal: conferma l'accesso e l'agente riceverà un modello e i servizi senza chiavi separate per ciascuno. 4. ### Verifica l'installazione ```bash hermes doctor ``` Il comando mostra cosa è installato, cosa manca e come correggerlo. I segni verdi indicano che è tutto a posto. Prima di aggiungere un bot e una pianificazione, assicurati che una semplice conversazione funzioni direttamente sul server: esegui `hermes` e assegnagli un compito semplice con una risposta verificabile. La documentazione sconsiglia esplicitamente di aggiungere funzionalità prima che funzioni una normale conversazione: un consiglio sensato. ## Come mantenere Hermes attivo 24 ore su 24?
Punti chiave Prima configura il gateway con `hermes gateway setup` e collega Telegram. Poi trasforma il gateway in un servizio con un solo comando: `hermes gateway install` installa un servizio utente, mentre `sudo hermes gateway install --system` installa un servizio di sistema che si avvia quando parte il server. Per il servizio utente usa `hermes gateway start`, `stop` e `status`. Per quello di sistema sul VPS mantieni esplicitamente `--system` e i privilegi necessari in ogni controllo e modifica.
Il gateway è un unico processo Hermes in background che mantiene le connessioni a tutti i messenger, gestisce le sessioni ed esegue le attività pianificate. Tutto il funzionamento 24 ore su 24 ruota attorno a esso. L'obiettivo è fare in modo che questo processo si avvii da solo e resti in funzione. Per prima cosa configura il gateway e collega un messenger: ```bash hermes gateway setup ``` La procedura guidata ti accompagna nella configurazione delle piattaforme e ti aiuta a inserire il token del bot e l'elenco degli utenti autorizzati. I passaggi per collegare Telegram (creare un bot con BotFather, trovare il proprio ID e inserire il token) sono spiegati nella [guida principale all'installazione](https://ailoot.ai/blog/it/hermes-agent-install-setup/); non li ripeterò qui. Poi arriva l'errore in cui si cade più spesso. Se esegui semplicemente `hermes gateway`, il processo resta attivo solo finché la sessione SSH è aperta. Chiudi il terminale e il gateway si arresta. Per mantenerlo sempre in funzione, devi affidarlo al controllo del sistema. Basta un comando: ```bash hermes gateway install ``` Installa il gateway come servizio: su Linux, un servizio systemd utente; su macOS, tramite launchd. Il sistema monitora il processo e lo riavvia se va in crash. Su un server, più spesso ti servirà la seconda opzione: un servizio di sistema che si avvia all'accensione della macchina, prima che acceda qualsiasi utente: ```bash sudo hermes gateway install --system ``` È proprio quello che serve per un VPS: il server si riavvia, il servizio parte da solo e il bot torna online. Gestiscilo con questi semplici comandi: ```bash hermes gateway start # avvia hermes gateway stop # arresta hermes gateway status # controlla lo stato ``` Per un servizio di sistema, aggiungi `sudo` e il flag `--system` a questi comandi. Altrimenti i comandi agiranno sul servizio utente invece che su quello che parte all'avvio: ```bash sudo hermes gateway start --system sudo hermes gateway stop --system sudo hermes gateway status --system ``` ## Perché serve linger e cosa non funziona senza?
Punti chiave Se hai installato il gateway come servizio utente (senza `--system`), systemd lo arresta non appena esci da SSH e non lo avvia all'accensione. Risolvi con un solo comando: `sudo loginctl enable-linger username`. In seguito, il servizio funziona indipendentemente dai tuoi accessi e disconnessioni.
Questo è l'inciampo più comune: hai installato il servizio, ma il bot smette comunque di funzionare di notte. La ragione dipende dal funzionamento dei servizi utente in Linux. Per impostazione predefinita, un servizio systemd utente è legato alla tua sessione. Ti colleghi tramite SSH e si avvia il gestore del tuo utente; il servizio entra in funzione. Ti disconnetti e il sistema considera inattivo l'utente, quindi arresta i suoi servizi insieme al gateway. Su un server a cui ti colleghi e da cui ti disconnetti, questo è un problema: il bot è online solo quando sei collegato via SSH. Puoi risolvere con la modalità linger, che consente al sistema di mantenere attivo il gestore utente anche quando quell'utente non è connesso: ```bash sudo loginctl enable-linger username ``` Dopo questo comando, il servizio utente funziona da solo e si avvia all'accensione del server, senza aspettare che tu acceda. Senza linger, si torna al comportamento iniziale: il gateway si arresta quando esci da SSH e non si avvia all'accensione. La documentazione lo afferma esplicitamente.
Attenzione Questo non si applica al servizio di sistema (installato con `sudo hermes gateway install --system`): funziona già a livello di macchina e si avvia all'accensione. Linger serve solo per un servizio utente. Scegli una delle due opzioni: servizio di sistema oppure servizio utente con linger.
## Come eseguire Hermes su un server in Docker con riavvii automatici?
Punti chiave Se preferisci Docker, puoi mantenere Hermes attivo come gateway persistente in un container: docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data -p 8642:8642 nousresearch/hermes-agent gateway run. Il flag --restart unless-stopped riavvia il container dopo un riavvio, e all'interno dell'immagine anche il processo gateway viene riavviato in caso di crash.
Docker è un altro metodo valido per mantenere l'agente su un server, soprattutto se hai già familiarità con i container o vuoi isolare l'agente dal sistema principale. Configuralo una volta con `docker run ... setup`, poi avvia il container in background: ```bash docker run -d \ --name hermes \ --restart unless-stopped \ -v ~/.hermes:/opt/data \ -p 8642:8642 \ nousresearch/hermes-agent gateway run ``` Ecco cosa fanno le righe responsabili del funzionamento 24 ore su 24: - `-d` — il container viene eseguito in background e non tiene aperto il terminale. - `--restart unless-stopped` — Docker riavvia il container dopo il riavvio del server o un crash. Non lo riavvia solo se lo hai arrestato manualmente. - `-v ~/.hermes:/opt/data` — impostazioni, chiavi, sessioni e memoria risiedono sul server, fuori dal container, e sopravvivono alla sua ricreazione. L'immagine aggiunge un'altra protezione: il processo gateway viene eseguito sotto il supervisore s6. Se il gateway va in crash, viene riavviato entro un paio di secondi senza perdere il container. È una doppia protezione: Docker mantiene attivo il container dall'esterno, mentre s6 monitora il processo al suo interno. Ricorda una differenza nell'approccio Docker: queste installazioni non si aggiornano con il comando `hermes update`. Per aggiornare Docker, sostituisci l'immagine con una nuova: scarica la più recente e ricrea il container. ## Come verificare che tutto funzioni e superi un riavvio?
Punti chiave Controlla lo stato del servizio con systemctl e segui il log in tempo reale. Poi fai la prova principale sul server: riavvia la macchina e verifica che il bot torni online da solo. Le sessioni e le risposte di Hermes sopravvivono a un riavvio; una risposta non terminata verrà inviata dopo il ripristino.
Per un servizio utente, controlla lo stato e i log così: ```bash hermes gateway status journalctl --user -u hermes-gateway -f ``` Per il servizio di sistema consigliato su VPS usa invece l’ambito di sistema: ```bash sudo hermes gateway status --system sudo journalctl -u hermes-gateway -f ``` Il primo comando controlla il servizio selezionato, il secondo segue i log nello stesso ambito. Questi nomi valgono per `~/.hermes` predefinito. Altri Hermes home possono avere un suffisso nell’unità: esamina lo stato e usa il nome esatto. Non monitorare un’unità utente mentre provi un’installazione di sistema. I log di Hermes si trovano in `~/.hermes/logs/` e i segreti vengono oscurati automaticamente, quindi puoi inviarli all'assistenza in sicurezza. Ora riavvia il server e verifica che l'agente torni in funzione da solo. È la prova principale sul server, e spesso è proprio quella che si dimentica: ```bash sudo reboot ``` Quando il server torna raggiungibile, ricollegati tramite SSH. Per l’installazione di sistema controlla `sudo hermes gateway status --system` e il journal di sistema; per quella utente con linger, `hermes gateway status` e il journal utente. Poi invia un messaggio al bot Telegram. Se risponde senza il tuo intervento, l'avvio automatico è configurato correttamente. Era questo l'obiettivo. Non devi preoccuparti di perdere la conversazione. Hermes scrive le sessioni su disco e queste sopravvivono al riavvio del gateway. Inoltre, se il gateway va in crash proprio mentre invia una risposta, la consegnerà dopo il ripristino invece di eseguire di nuovo l'attività. Questo è importante per un bot attivo 24 ore su 24: un riavvio imprevisto non interromperà la conversazione. ## Come proteggere un agente con accesso al terminale su un server?
Punti chiave Le tre protezioni principali: per impostazione predefinita l'accesso al bot è chiuso (risponde solo alle persone presenti nell'elenco), l'agente chiede conferma prima di eseguire comandi pericolosi e, per un isolamento completo, esegui l'agente sul server in una sandbox Docker. È meglio non attivare la modalità senza conferma (YOLO) su un server.
Un agente su un server è un programma con accesso al terminale che funziona senza la tua supervisione. Controlla prima queste tre impostazioni. **Accesso al bot chiuso.** Per impostazione predefinita, il gateway risponde solo alle persone presenti nell'elenco di accesso o a quelle che hanno completato il collegamento tramite codice in un messaggio diretto. È il comportamento giusto per un bot con accesso al terminale: uno sconosciuto che scrive al bot non può fare nulla. L'elenco si configura usando ID numerici, per esempio per Telegram: ```bash TELEGRAM_ALLOWED_USERS=123456789,987654321 ``` **Conferma per i comandi pericolosi.** Prima di fare qualcosa di distruttivo, l'agente chiede il tuo permesso. Esiste una modalità YOLO che disattiva le conferme; è meglio non abilitarla su un server che funziona senza di te. Le conferme servono proprio a impedire che accada qualcosa di irreversibile a tua insaputa. **Sandbox per un isolamento completo.** Se vuoi che l'agente non possa fisicamente vedere il sistema principale del server, esegui i suoi comandi in un container Docker: ```bash hermes config set terminal.backend docker ``` A quel punto, tutto ciò che l'agente fa nel terminale avviene in una sandbox isolata e non può raggiungere il server attivo. È una protezione sensata quando concedi all'agente libertà di agire da solo. ## Cosa fare se il bot tace o il gateway va in crash?
Punti chiave Controlla innanzitutto lo stato del servizio e i log; spesso la causa è il token del bot, l'elenco di accesso o il modello. Se l'intero processo si blocca del tutto, un servizio systemd ha un timer watchdog che riavvia il gateway se smette di mostrare segni di vita.
Quando il bot smette di rispondere, segui questo ordine. Controlla prima l’ambito installato: `sudo hermes gateway status --system` e journal di sistema per un servizio di sistema, oppure `hermes gateway status` e journal utente per quello utente. Se il gateway è in funzione ma i messaggi non arrivano, quasi sempre si tratta di un problema di configurazione della piattaforma: il token del bot è errato oppure la persona non è nell'elenco di accesso. Ripeti `hermes gateway setup` nello stesso Hermes home, poi controlla il servizio scelto con `hermes gateway status --system` per sistema o `hermes gateway status` per utente. Un setup riuscito non dimostra che sia attivo il gateway corretto. Se il modello restituisce risposte vuote o strane, controllalo con `hermes model` e conferma il provider e l'accesso. La sequenza generale di ripristino per passare da «è tutto rotto» a una situazione funzionante è: `hermes doctor`, `hermes model`, `hermes setup`, poi `hermes gateway status --system` per l’installazione di sistema oppure `hermes gateway status` per quella utente. Un'ultima cosa per il caso raro ma spiacevole in cui l'intero processo si blocca senza andare effettivamente in crash. Un servizio systemd dispone di un timer watchdog: aggiungi questa riga a `~/.hermes/config.yaml` e reinstalla il servizio. ```yaml gateway: systemd_watchdog_seconds: 120 ``` ```bash # For the VPS system service (same Hermes home as the original install): sudo hermes gateway install --system --force sudo hermes gateway status --system ``` Per un servizio utente rigenera invece solo quell’ambito con `hermes gateway install --force` e controlla `hermes gateway status`. Scegli un ambito: non installarli entrambi per riparare un singolo gateway. Dopodiché il gateway segnala regolarmente al sistema: «Sono attivo»; se i segnali si interrompono, systemd riavvia automaticamente il processo. Funziona solo su Linux con systemd e solo in caso di blocco del processo. Il timer watchdog non influisce su una normale interruzione di rete tra il server e il messenger. ## Cos'altro si chiede su Hermes Agent su un server?
Punti chiave Risposte rapide alle domande più comuni: se sia necessario proprio un VPS, se si possano mantenere più bot su una sola macchina, se il server abbia bisogno di un'interfaccia grafica e cosa succede alle attività pianificate quando l'agente è su un server.
### Domande frequenti Devo per forza prendere un VPS o va bene il mio computer? Per il funzionamento 24 ore su 24 serve una macchina sempre accesa. Il tuo computer va bene solo se sei disposto a non spegnerlo mai. Un VPS è più comodo: è sempre acceso e non dipende dal fatto che tu stia lavorando o dormendo. Basta un normale server Linux: la documentazione indica Linux come piattaforma supportata di primo livello e i test vengono eseguiti su una nuova installazione di Ubuntu. Posso eseguire più bot su un server? Sì. Hermes ha i profili e ogni profilo ha il proprio servizio. Un comando come \ gateway install crea un servizio separato chiamato hermes-gateway-\, e funzionano in modo indipendente. Ogni profilo ha le proprie impostazioni, il token del bot e la memoria. Il server ha bisogno di un monitor e di una scheda grafica? No. Il server funziona senza schermo e lo gestisci tramite SSH dal terminale. L'automazione del browser di solito non serve per un agente su un server di questo tipo, quindi esegui l'installer con il flag --skip-browser: così elimini l'unico componente pesante che richiede una scheda grafica. Le attività pianificate vengono eseguite mentre sono via? Sì, è proprio il motivo per cui si passa a un server. Lo stesso gateway esegue le attività pianificate: controlla la pianificazione una volta al minuto ed esegue le attività quando arriva il momento, quindi invia il risultato alla stessa chat. Poiché il gateway funziona 24 ore su 24 come servizio, la pianificazione procede da sola, senza il tuo intervento. Il bot sopravvive a un aggiornamento e al riavvio del server? Sì. Impostazioni, sessioni e memoria sono conservate nella cartella ~/.hermes e non vanno perse. Dopo un riavvio, il servizio di sistema (o Docker con --restart unless-stopped) avvia il gateway da solo. Una risposta non terminata verrà inviata dopo il riavvio e non si perderà nulla; tuttavia, se al momento del crash la risposta era già a metà invio, potrebbe arrivare di nuovo con un avviso di possibile duplicato.
### Fonti - [Hermes Agent, Installazione](https://hermes-agent.nousresearch.com/docs/getting-started/installation) - [Hermes Agent, Guida rapida](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) - [Hermes Agent, Piattaforme supportate](https://hermes-agent.nousresearch.com/docs/getting-started/platform-support) - [Hermes Agent, Gateway di messaggistica](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) - [Hermes Agent, Esecuzione in Docker](https://hermes-agent.nousresearch.com/docs/user-guide/docker) - [Hermes Agent, Attività pianificate](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) - [Hermes Agent, Nous Portal](https://hermes-agent.nousresearch.com/docs/integrations/nous-portal) - [Hermes Agent, Documentazione](https://hermes-agent.nousresearch.com/docs/)
Scopri [Ailoot](https://ailoot.ai/). ## Domande frequenti ### Perché il gateway sembra fermo dopo l’installazione come servizio di sistema? Un controllo senza ambito può riguardare un altro servizio. Usa `hermes gateway status --system` e il journal di sistema per quell’installazione; stato senza opzione e journal utente solo per un servizio utente. Mantieni sempre lo stesso Hermes home. ### Un servizio di sistema su VPS richiede loginctl linger? No. Linger serve al servizio systemd utente che deve sopravvivere all’uscita e avviarsi all’accensione. Quello di sistema parte già con la macchina: scegli un solo ambito e ripeti stato e risposta del bot dopo il riavvio. ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.