Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04

di Raffaele Chiatto | Nov 18, 2026 | 0 commenti

Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto

 

Assistenza agli utenti, manutenzione di server e postazioni, interventi urgenti fuori orario: per chi lavora nell’IT il controllo remoto è uno strumento quotidiano.

Le soluzioni commerciali più diffuse, come TeamViewer o AnyDesk, sono comode, ma hanno costi di licenza che crescono in fretta con il numero di tecnici e di dispositivi.

Inoltre fanno transitare le sessioni attraverso infrastrutture di terze parti, un aspetto sempre più delicato per chi deve rispettare i requisiti di NIS2, ISO 27001 o semplicemente le policy di sicurezza dei propri clienti.

MeshCentral è un’alternativa open source e completamente self-hosted.

Si tratta di una piattaforma web di gestione remota, basata su Node.js, che permette di controllare da un semplice browser computer Windows, Linux e macOS su cui è installato un agent leggero.

Offre desktop remoto, terminale, trasferimento file, gestione dei processi e dei servizi, oltre all’organizzazione dei dispositivi in gruppi con permessi granulari per utenti e tecnici.

Supporta anche Intel AMT per la gestione out-of-band. Tutto questo gira sul proprio server, senza limiti sul numero di dispositivi e senza costi di licenza.

In questo articolo vediamo come installare e configurare MeshCentral su Ubuntu Server 26.04 LTS: dalla preparazione del sistema e l’installazione di Node.js fino alla configurazione del file config.json, all’avvio come servizio systemd e al primo accesso all’interfaccia web.

 

PREREQUISITI

MeshCentral è una piattaforma open source di gestione e controllo remoto (desktop, terminale, file) basata su Node.js. In questa guida lo installiamo come servizio nativo, con database NeDB integrato e certificato Let’s Encrypt.

 

Requisito Valore consigliato
Sistema operativo Ubuntu Server 26.04 LTS, installazione minimale aggiornata
CPU / RAM 2 vCPU, 2 GB RAM (fino a ~100 agent); 4 GB per installazioni più grandi
Disco 20 GB (registrazioni sessioni e backup crescono nel tempo)
Rete IP statico o NAT; porte 80 e 443 TCP raggiungibili da Internet
DNS Record A pubblico, es. mesh.example.com, che punta all’IP del server
Accesso Utente con privilegi sudo

Negli esempi sostituisci mesh.example.com con il tuo FQDN e [email protected] con la tua email.

 

PREPARAZIONE DEL SISTEMA

Aggiorna il server, imposta hostname e fuso orario, e apri solo le porte necessarie.

Configura il firewall UFW (consenti SSH prima di attivarlo per non perdere l’accesso):

Crea un utente di sistema dedicato, senza shell di login, con home in /opt/meshcentral:

Se il server è dietro un firewall perimetrale (es. FortiGate), crea un VIP/port-forward di 80 e 443 TCP verso l’IP interno del server.

 

INSTALLAZIONE DI NODE.JS

Ubuntu 26.04 include Node.js 22 LTS nei repository ufficiali, sufficiente per MeshCentral (fonte: Linuxize, vedi Fonti).

Opzione A — repository Ubuntu (consigliata, aggiornata con apt):

Verificare la versione installata con il comando:

Dovremmo visualizzare il seguente output:

Quindi eseguire il comando:

Dovremmo visualizzare il seguente output:

 

Opzione B — NodeSource, Node.js 24 LTS:

Con NodeSource npm è già incluso nel pacchetto nodejs: non installare il pacchetto npm di Ubuntu.

 

INSTALLAZIONE DI MESHCENTRAL

Installa il pacchetto npm come utente meshcentral, dentro /opt/meshcentral. Non usare npm install -g: MeshCentral installa da solo moduli aggiuntivi al primo avvio e deve poter scrivere nella propria cartella.

Verifica la versione installata:

Dovremmo visualizzare il seguente output:

Struttura finale:

 

 

CONFIGURAZIONE DEL CONFIG.JSON

Crea /opt/meshcentral/meshcentral-data/config.json. MeshCentral ignora le chiavi che iniziano con _: è il modo per disattivare un’opzione senza cancellarla.

Quindi incollare all’interno questo output:

Punti chiave:

  • cert: deve coincidere con il FQDN pubblico, perché viene inserito negli agent.
  • WANonly: disattiva la scoperta in LAN; usalo per un server raggiungibile da Internet.
  • agentPong: keep-alive ogni 300 secondi, evita che firewall/NAT chiudano le connessioni inattive degli agent.
  • newAccounts: lascialo a true solo fino alla creazione del primo amministratore (passo 7).
  • letsencrypt.production: parti con false (staging) per verificare la challenge HTTP sulla porta 80; quando funziona passa a true e riavvia.

Valida la sintassi prima di avviare:

 

CREAZIONE DEL SERVIZIO SYSTEMD

L’utente meshcentral non è root, quindi gli serve la capability CAP_NET_BIND_SERVICE per aprire le porte 80 e 443. La concediamo nel servizio con AmbientCapabilities, senza setcap sul binario di Node (che verrebbe perso a ogni aggiornamento).

Quindi incollare all’interno questo output:

Avvia e abilita il servizio:

Il primo avvio richiede 1–2 minuti: MeshCentral scarica i moduli npm mancanti, genera i certificati interni e richiede quello Let’s Encrypt. Nel log cerca MeshCentral HTTPS server running on mesh.example.com:443. Verifica le porte in ascolto:

Se il certificato di staging viene emesso correttamente, imposta “production”: true in config.json ed esegui sudo systemctl restart meshcentral.

 

PRIMO ACCESSO E INSTALLAZIONE DEGLI AGENT

Il primo account creato diventa amministratore completo del server: crealo subito dopo l’avvio.

Apri da un qualsiasi briowser https://mesh.example.com

Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto

Clicca Create one per registrare l’account amministratore

Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto

Inserire tutti i campi richiesti quindli cliccare Create Account

Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto

Se è andato tutto a buon fine dovoremmo visualizzare la Dashboard di MeshCentral per il supporto remoto

 

COSE DA FARE POST INSTALLAZIONE

Blocca le registrazioni: in config.json imposta “newAccounts”: false nel dominio “” e riavvia con sudo systemctl restart meshcentral.

Attiva la 2FA: My Account → Security → Manage authenticator app (TOTP, es. Microsoft Authenticator).

Crea un gruppo dispositivi: My Devices → Add Device Group, tipo Manage using a software agent, es. un gruppo per cliente.

Installa l’agent: nel gruppo clicca Add Agent, scegli il sistema operativo e scarica l’installer.

  • Windows: esegui il .exe come amministratore e clicca Install.
  • Linux/macOS: copia il comando wget … sudo bash mostrato nella finestra.

Verifica che il dispositivo compaia online nel gruppo e prova Desktop, Terminal e Files.

ATTENZIONE: Per distribuzioni di massa su Windows (GPO, Intune, RMM) usa l’installer con parametri -fullinstall oppure il file .msh del gruppo insieme a meshagent.exe.

 

MANUTENZIONE E OPZIONI AVANZATE

Aggiornare MeshCentral

Con selfUpdate: false l’aggiornamento è manuale e controllato:

Gli agent si aggiornano da soli dopo il riavvio del server.

Backup

I backup automatici (passo 5) finiscono in /opt/meshcentral/meshcentral-backups. Copiali fuori dal server (es. Veeam, rsync o snapshot VM). Per un ripristino completo servono soprattutto meshcentral-data (certificati inclusi: senza di essi gli agent non si riconnettono) e meshcentral-files.

Reverse proxy Nginx (opzionale)

Se la porta 443 è già usata da Nginx, MeshCentral ascolta in HTTP su una porta interna e Nginx gestisce il TLS. Modifica settings così (e rimuovi la sezione letsencrypt, usando Certbot su Nginx):

Blocco location minimo in Nginx:

 

MongoDB (opzionale)

NeDB basta per qualche centinaio di agent. Oltre, usa MongoDB aggiungendo in settings “mongoDb”: “mongodb://127.0.0.1:27017/meshcentral”. Prima verifica che MongoDB pubblichi pacchetti ufficiali per Ubuntu 26.04; in alternativa eseguilo in un container Docker.

 

RIZOLUZIONE DEI PROBLEMI

Servizio in crash al primo avvio – Errore di sintassi in config.json – python3 -m json.tool sul file; journalctl -u meshcentral -n 50

EACCES su porta 80/443 – Capability mancante – Controlla AmbientCapabilities nella unit, poi daemon-reload

Certificato Let’s Encrypt non emesso – Porta 80 non raggiungibile o DNS errato – dig mesh.example.com, port-forward 80, production ancora false

Agent offline dopo cambio certificato/nome – cert diverso dal FQDN usato dagli agent – Ripristina cert e i file *-cert-* in meshcentral-data

Agent che si disconnettono ogni pochi minuti – Timeout NAT/firewall o proxy – agentPong 300; timeout Nginx ≥ 330 s

CONSIDERAZIONI FINALI

Con questa guida abbiamo installato MeshCentral su Ubuntu Server 26.04 LTS.

Il risultato è una piattaforma di controllo remoto completa, interamente sotto il nostro controllo, pronta per distribuire gli agent e iniziare a gestire postazioni e server.

PRO

  • Open source e gratuito: rilasciato con licenza Apache 2.0, senza costi di licenza né limiti sul numero di dispositivi o di tecnici.
  • Completamente self-hosted: le sessioni remote non passano da infrastrutture di terze parti. È un vantaggio concreto per privacy, compliance NIS2/ISO 27001 e policy dei clienti.
  • Funzionalità complete: desktop remoto, terminale, trasferimento file, gestione di processi e servizi, inventario hardware e software, tutto dal browser.
  • Multipiattaforma: agent per Windows, Linux e macOS, oltre al supporto Intel AMT per la gestione out-of-band.
  • Adatto agli MSP: grazie a domini multipli, gruppi di dispositivi e permessi granulari, permette di separare clienti e tecnici sulla stessa istanza.
  • Sicurezza e autenticazione: supporta autenticazione a due fattori e integrazione con LDAP, SAML e OpenID Connect.
  • Leggero: gira senza problemi su una VM modesta, anche con centinaia di agent collegati.

CONTRO

  • Interfaccia datata: è funzionale ma poco moderna rispetto alle soluzioni commerciali, e all’inizio può risultare dispersiva.
  • Configurazione tutta in config.json: molte opzioni importanti (nome del server, origini consentite, porte, reverse proxy) si impostano solo a mano nel file, e un errore genera messaggi poco chiari, come abbiamo
  • visto con l’“Invalid origin”.
  • Documentazione frammentata: la guida ufficiale esiste, ma molte informazioni utili sono sparse tra issue su GitHub, discussioni e video.
  • Falsi positivi degli antivirus: dato che è uno strumento di accesso remoto, a volte usato anche in modo malevolo, alcuni antivirus ed EDR segnalano l’agent e vanno configurate le esclusioni.
  • Sviluppo concentrato su pochi maintainer: il progetto è attivo, ma dipende in larga parte dal suo autore principale e dalla community, senza un supporto commerciale strutturato.
  • Certificati da gestire: in rete locale, senza Let’s Encrypt, bisogna gestire certificati self-signed o una CA interna, e il nome configurato deve corrispondere a quello usato per accedere.

 

In conclusione, MeshCentral è una delle migliori alternative open source a TeamViewer e AnyDesk per chi vuole il pieno controllo dell’infrastruttura di assistenza remota.

È particolarmente adatto a reparti IT interni, consulenti e MSP che gestiscono più clienti e vogliono eliminare i costi di licenza senza rinunciare alle funzionalità.

Richiede in cambio un po’ più di attenzione in fase di configurazione e manutenzione, ma una volta messo a punto è uno strumento solido e affidabile da usare ogni giorno.

Articoli Recenti

Veeam Backup

Monitoring

Friends

  • My English Lab  English School
  • ChrSystem   Servizi ICT
  • Since 01  Kreative Graphics

Database

Networking

Autori

  • Raffaele Chiatto  Amministratore
  • Marco Valle  Autore
  • Angelo Lauria  Autore
  • Edoardo Prot  Autore
  • Davide D'Urso  Autore
Raffaele Chiatto

Raffaele Chiatto

Sono Raffaele Chiatto, un appassionato di informatica a 360 gradi.
Tutto è iniziato nel 1996, quando ho scoperto il mondo dell'informatica grazie a Windows 95, e da quel momento non ho più smesso di esplorare e imparare.
Ogni giorno mi dedico con curiosità e passione a scoprire le nuove frontiere di questo settore in continua evoluzione.

Related Post

0 Commenti

Invia Un Commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *

Virtualizzazione

Linux

Microsoft

Apple

Backup

Database

Security

Automazione