<?xml version="1.0" encoding="UTF-8" standalone="no"?><rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:slash="http://purl.org/rss/1.0/modules/slash/" xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" version="2.0">

<channel>
	<title>RaffaeleChiatto.com</title>
	<atom:link href="https://www.raffaelechiatto.com/feed/" rel="self" type="application/rss+xml"/>
	<link>https://www.raffaelechiatto.com</link>
	<description>Il Blog di Informatica a 360°</description>
	<lastBuildDate>Wed, 18 Nov 2026 08:43:38 +0000</lastBuildDate>
	<language>it-IT</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	

<image>
	<url>https://www.raffaelechiatto.com/wp-content/uploads/2025/05/favicon-150x150.png</url>
	<title>RaffaeleChiatto.com</title>
	<link>https://www.raffaelechiatto.com</link>
	<width>32</width>
	<height>32</height>
</image> 
	<itunes:explicit>no</itunes:explicit><itunes:subtitle>Il Blog di Informatica a 360°</itunes:subtitle><itunes:category text="Technology"><itunes:category text="Gadgets"/></itunes:category><item>
		<title>Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04</title>
		<link>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-meshcentral-su-ubuntu-server-26-04/</link>
					<comments>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-meshcentral-su-ubuntu-server-26-04/#respond</comments>
		
		<dc:creator><![CDATA[Raffaele Chiatto]]></dc:creator>
		<pubDate>Wed, 18 Nov 2026 08:43:38 +0000</pubDate>
				<category><![CDATA[MeshCentral]]></category>
		<category><![CDATA[Ubuntu]]></category>
		<category><![CDATA[Help Desk]]></category>
		<category><![CDATA[Node.js]]></category>
		<guid isPermaLink="false">https://www.raffaelechiatto.com/?p=1125313</guid>

					<description><![CDATA[&#160; 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 [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img loading="lazy" decoding="async" class="size-full wp-image-1091058 alignnone" src="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png" alt="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto" width="679" height="89" title="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 5" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png 679w, https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR-480x63.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 679px, 100vw" /></p>
<p>&nbsp;</p>
<p>Assistenza agli utenti, manutenzione di server e postazioni, interventi urgenti fuori orario: per chi lavora nell’IT il controllo remoto è uno strumento quotidiano.</p>
<p>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.</p>
<p>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.</p>
<p>MeshCentral è un’alternativa open source e completamente self-hosted.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
<p>&nbsp;</p>
<h3><strong>PREREQUISITI</strong></h3>
<p>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&#8217;s Encrypt.</p>
<p>&nbsp;</p>
<table style="height: 100%; width: 100%; border-style: solid;" border="2">
<thead>
<tr>
<th scope="col">Requisito</th>
<th scope="col">Valore consigliato</th>
</tr>
</thead>
<tbody>
<tr>
<td>Sistema operativo</td>
<td>Ubuntu Server 26.04 LTS, installazione minimale aggiornata</td>
</tr>
<tr>
<td>CPU / RAM</td>
<td>2 vCPU, 2 GB RAM (fino a ~100 agent); 4 GB per installazioni più grandi</td>
</tr>
<tr>
<td>Disco</td>
<td>20 GB (registrazioni sessioni e backup crescono nel tempo)</td>
</tr>
<tr>
<td>Rete</td>
<td>IP statico o NAT; porte 80 e 443 TCP raggiungibili da Internet</td>
</tr>
<tr>
<td>DNS</td>
<td>Record A pubblico, es. mesh.example.com, che punta all’IP del server</td>
</tr>
<tr>
<td>Accesso</td>
<td>Utente con privilegi sudo</td>
</tr>
</tbody>
</table>
<p>Negli esempi sostituisci mesh.example.com con il tuo FQDN e admin@example.com con la tua email.</p>
<p>&nbsp;</p>
<h3><strong>PREPARAZIONE DEL SISTEMA</strong></h3>
<p>Aggiorna il server, imposta hostname e fuso orario, e apri solo le porte necessarie.</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt update &amp;&amp; sudo apt full-upgrade -y
sudo apt install -y curl ca-certificates gnupg ufw
sudo hostnamectl set-hostname mesh
sudo timedatectl set-timezone Europe/Rome</pre><p>Configura il firewall UFW (consenti SSH prima di attivarlo per non perdere l&#8217;accesso):</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose</pre><p>Crea un utente di sistema dedicato, senza shell di login, con home in /opt/meshcentral:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo useradd --system --create-home --home-dir /opt/meshcentral --shell /usr/sbin/nologin meshcentral</pre><p>Se il server è dietro un firewall perimetrale (es. FortiGate), crea un VIP/port-forward di 80 e 443 TCP verso l&#8217;IP interno del server.</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI NODE.JS</strong></h3>
<p>Ubuntu 26.04 include Node.js 22 LTS nei repository ufficiali, sufficiente per MeshCentral (fonte: Linuxize, vedi Fonti).</p>
<p><strong>Opzione A — repository Ubuntu (consigliata, aggiornata con apt)</strong>:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y nodejs npm</pre><p>Verificare la versione installata con il comando:</p><pre class="urvanov-syntax-highlighter-plain-tag">node --version</pre><p>Dovremmo visualizzare il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">v22.22.1</pre><p>Quindi eseguire il comando:</p><pre class="urvanov-syntax-highlighter-plain-tag">npm --version</pre><p>Dovremmo visualizzare il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">9.2.0</pre><p>&nbsp;</p>
<p><strong>Opzione B — NodeSource, Node.js 24 LTS:</strong></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
NODE_MAJOR=24
ARCH=$(dpkg --print-architecture)
sudo tee /etc/apt/sources.list.d/nodesource.sources &gt; /dev/null &lt;&lt;EOF
Types: deb
URIs: https://deb.nodesource.com/node_${NODE_MAJOR}.x
Suites: nodistro
Components: main
Architectures: ${ARCH}
Signed-By: /etc/apt/keyrings/nodesource.gpg
EOF
sudo apt update &amp;&amp; sudo apt install -y nodejs
node --version # atteso v24.x</pre><p>Con NodeSource npm è già incluso nel pacchetto nodejs: non installare il pacchetto npm di Ubuntu.</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI MESHCENTRAL</strong></h3>
<p>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.</p><pre class="urvanov-syntax-highlighter-plain-tag">cd /opt/meshcentral
sudo -u meshcentral -H npm install meshcentral
sudo -u meshcentral mkdir -p /opt/meshcentral/meshcentral-data /opt/meshcentral/meshcentral-files /opt/meshcentral/meshcentral-backups</pre><p>Verifica la versione installata:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo -u meshcentral -H npm ls meshcentral</pre><p>Dovremmo visualizzare il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">meshcentral@ /opt/meshcentral
└── meshcentral@1.3.1</pre><p>Struttura finale:</p><pre class="urvanov-syntax-highlighter-plain-tag">/opt/meshcentral/node_modules/meshcentral - Codice dell'applicazione

/opt/meshcentral/meshcentral-data - config.json, certificati, database NeDB

/opt/meshcentral/meshcentral-files - File caricati dagli utenti

/opt/meshcentral/meshcentral-backups - Backup automatici</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>CONFIGURAZIONE DEL CONFIG.JSON</strong></h3>
<p>Crea <strong>/opt/meshcentral/meshcentral-data/config.json</strong>. MeshCentral ignora le chiavi che iniziano con _: è il modo per disattivare un&#8217;opzione senza cancellarla.</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo -u meshcentral nano /opt/meshcentral/meshcentral-data/config.json</pre><p>Quindi incollare all&#8217;interno questo output:</p><pre class="urvanov-syntax-highlighter-plain-tag">{
"$schema": "https://raw.githubusercontent.com/Ylianst/MeshCentral/master/meshcentral-config-schema.json",
"settings": {
"cert": "mesh.example.com",
"WANonly": true,
"port": 443,
"redirPort": 80,
"agentPong": 300,
"selfUpdate": false,
"autoBackup": {
"backupIntervalHours": 24,
"keepLastDaysBackup": 14,
"backupPath": "/opt/meshcentral/meshcentral-backups"
}
},
"domains": {
"": {
"title": "Remote Support",
"title2": "MeshCentral",
"newAccounts": true,
"minify": true
}
},
"letsencrypt": {
"email": "admin@example.com",
"names": "mesh.example.com",
"rsaKeySize": 3072,
"production": false
}
}</pre><p>Punti chiave:</p>
<ul>
<li>cert: deve coincidere con il FQDN pubblico, perché viene inserito negli agent.</li>
<li>WANonly: disattiva la scoperta in LAN; usalo per un server raggiungibile da Internet.</li>
<li>agentPong: keep-alive ogni 300 secondi, evita che firewall/NAT chiudano le connessioni inattive degli agent.</li>
<li>newAccounts: lascialo a true solo fino alla creazione del primo amministratore (passo 7).</li>
<li>letsencrypt.production: parti con false (staging) per verificare la challenge HTTP sulla porta 80; quando funziona passa a true e riavvia.</li>
</ul>
<p>Valida la sintassi prima di avviare:</p><pre class="urvanov-syntax-highlighter-plain-tag">python3 -m json.tool /opt/meshcentral/meshcentral-data/config.json &gt; /dev/null &amp;&amp; echo OK</pre><p>&nbsp;</p>
<h3><strong>CREAZIONE DEL SERVIZIO SYSTEMD</strong></h3>
<p>L&#8217;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).</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo nano /etc/systemd/system/meshcentral.service</pre><p>Quindi incollare all&#8217;interno questo output:</p><pre class="urvanov-syntax-highlighter-plain-tag">[Unit]
Description=MeshCentral Server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=meshcentral
Group=meshcentral
WorkingDirectory=/opt/meshcentral
ExecStart=/usr/bin/node /opt/meshcentral/node_modules/meshcentral
Environment=NODE_ENV=production
AmbientCapabilities=CAP_NET_BIND_SERVICE
CapabilityBoundingSet=CAP_NET_BIND_SERVICE
NoNewPrivileges=true
LimitNOFILE=1000000
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target</pre><p>Avvia e abilita il servizio:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo systemctl daemon-reload

sudo systemctl enable --now meshcentral

sudo systemctl status meshcentral
sudo journalctl -u meshcentral -f</pre><p>Il primo avvio richiede 1–2 minuti: MeshCentral scarica i moduli npm mancanti, genera i certificati interni e richiede quello Let&#8217;s Encrypt. Nel log cerca MeshCentral HTTPS server running on mesh.example.com:443. Verifica le porte in ascolto:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo ss -tlnp | grep node</pre><p>Se il certificato di staging viene emesso correttamente, imposta &#8220;production&#8221;: true in config.json ed esegui sudo systemctl restart meshcentral.</p>
<p>&nbsp;</p>
<h3><strong>PRIMO ACCESSO E INSTALLAZIONE DEGLI AGENT</strong></h3>
<p>Il primo account creato diventa amministratore completo del server: crealo subito dopo l&#8217;avvio.</p>
<p>Apri da un qualsiasi briowser <strong>https://mesh.example.com</strong></p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-01.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125323 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-01-1024x570.png" alt="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="570" title="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 6" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-01-980x545.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-01-480x267.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Clicca <strong>Create one</strong> per registrare l&#8217;account amministratore</p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-02.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125324 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-02-1024x571.png" alt="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="571" title="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 7" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-02-980x547.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-02-480x268.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Inserire tutti i campi richiesti quindli cliccare <strong>Create Account</strong></p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-03.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125325 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-03-1024x556.png" alt="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="556" title="Installazione e Configurazione Base di MeshCentral su Ubuntu Server 26.04 8" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-03-980x532.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-meshcentral-ubuntu-03-480x261.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Se è andato tutto a buon fine dovoremmo visualizzare la Dashboard di MeshCentral per il supporto remoto</p>
<p>&nbsp;</p>
<h3><strong>COSE DA FARE POST INSTALLAZIONE</strong></h3>
<p><strong>Blocca le registrazioni</strong>: in config.json imposta &#8220;newAccounts&#8221;: false nel dominio &#8220;&#8221; e riavvia con sudo systemctl restart meshcentral.</p>
<p><strong>Attiva la 2FA</strong>: My Account → Security → Manage authenticator app (TOTP, es. Microsoft Authenticator).</p>
<p><strong>Crea un gruppo dispositivi</strong>: My Devices → Add Device Group, tipo Manage using a software agent, es. un gruppo per cliente.</p>
<p><strong>Installa l&#8217;agent:</strong> nel gruppo clicca Add Agent, scegli il sistema operativo e scarica l&#8217;installer.</p>
<ul>
<li>Windows: esegui il .exe come amministratore e clicca Install.</li>
<li>Linux/macOS: copia il comando wget … sudo bash mostrato nella finestra.</li>
</ul>
<p>Verifica che il dispositivo compaia online nel gruppo e prova Desktop, Terminal e Files.</p>
<p><strong>ATTENZIONE</strong>: Per distribuzioni di massa su Windows (GPO, Intune, RMM) usa l&#8217;installer con parametri -fullinstall oppure il file .msh del gruppo insieme a meshagent.exe.</p>
<p>&nbsp;</p>
<h3><strong>MANUTENZIONE E OPZIONI AVANZATE</strong></h3>
<p><strong>Aggiornare MeshCentral</strong></p>
<p>Con selfUpdate: false l&#8217;aggiornamento è manuale e controllato:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo systemctl stop meshcentral
cd /opt/meshcentral
sudo -u meshcentral -H npm install meshcentral@latest
sudo systemctl start meshcentral</pre><p>Gli agent si aggiornano da soli dopo il riavvio del server.</p>
<p><strong>Backup</strong></p>
<p>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.</p>
<p><strong>Reverse proxy Nginx (opzionale)</strong></p>
<p>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):</p><pre class="urvanov-syntax-highlighter-plain-tag">"port": 4430,
"aliasPort": 443,
"redirPort": 0,
"tlsOffload": "127.0.0.1",
"trustedProxy": "127.0.0.1"</pre><p>Blocco location minimo in Nginx:</p><pre class="urvanov-syntax-highlighter-plain-tag">location / {
proxy_pass http://127.0.0.1:4430/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_send_timeout 330s;
proxy_read_timeout 330s;
}</pre><p>&nbsp;</p>
<p><strong>MongoDB (opzionale)</strong></p>
<p>NeDB basta per qualche centinaio di agent. Oltre, usa MongoDB aggiungendo in settings &#8220;mongoDb&#8221;: &#8220;mongodb://127.0.0.1:27017/meshcentral&#8221;. Prima verifica che MongoDB pubblichi pacchetti ufficiali per Ubuntu 26.04; in alternativa eseguilo in un container Docker.</p>
<p>&nbsp;</p>
<h3><strong>RIZOLUZIONE DEI PROBLEMI</strong></h3>
<p><strong>Servizio in crash al primo avvio</strong> &#8211; Errore di sintassi in config.json &#8211; python3 -m json.tool sul file; journalctl -u meshcentral -n 50</p>
<p><strong>EACCES su porta 80/443</strong> &#8211; Capability mancante &#8211; Controlla AmbientCapabilities nella unit, poi daemon-reload</p>
<p><strong>Certificato Let&#8217;s Encrypt non emesso</strong> &#8211; Porta 80 non raggiungibile o DNS errato &#8211; dig mesh.example.com, port-forward 80, production ancora false</p>
<p><strong>Agent offline dopo cambio certificato/nome</strong> &#8211; cert diverso dal FQDN usato dagli agent &#8211; Ripristina cert e i file *-cert-* in meshcentral-data</p>
<p><strong>Agent che si disconnettono ogni pochi minuti</strong> &#8211; Timeout NAT/firewall o proxy &#8211; agentPong 300; timeout Nginx ≥ 330 s</p>
<h3></h3>
<h3><strong>CONSIDERAZIONI FINALI</strong></h3>
<p>Con questa guida abbiamo installato MeshCentral su Ubuntu Server 26.04 LTS.</p>
<p>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.</p>
<h4><strong>PRO</strong></h4>
<ul>
<li>Open source e gratuito: rilasciato con licenza Apache 2.0, senza costi di licenza né limiti sul numero di dispositivi o di tecnici.</li>
<li>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.</li>
<li>Funzionalità complete: desktop remoto, terminale, trasferimento file, gestione di processi e servizi, inventario hardware e software, tutto dal browser.</li>
<li>Multipiattaforma: agent per Windows, Linux e macOS, oltre al supporto Intel AMT per la gestione out-of-band.</li>
<li>Adatto agli MSP: grazie a domini multipli, gruppi di dispositivi e permessi granulari, permette di separare clienti e tecnici sulla stessa istanza.</li>
<li>Sicurezza e autenticazione: supporta autenticazione a due fattori e integrazione con LDAP, SAML e OpenID Connect.</li>
<li>Leggero: gira senza problemi su una VM modesta, anche con centinaia di agent collegati.</li>
</ul>
<h4></h4>
<h4><strong>CONTRO</strong></h4>
<ul>
<li>Interfaccia datata: è funzionale ma poco moderna rispetto alle soluzioni commerciali, e all’inizio può risultare dispersiva.</li>
<li>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</li>
<li>visto con l’“Invalid origin”.</li>
<li>Documentazione frammentata: la guida ufficiale esiste, ma molte informazioni utili sono sparse tra issue su GitHub, discussioni e video.</li>
<li>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.</li>
<li>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.</li>
<li>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.</li>
</ul>
<p>&nbsp;</p>
<p>In conclusione, MeshCentral è una delle migliori alternative open source a TeamViewer e AnyDesk per chi vuole il pieno controllo dell’infrastruttura di assistenza remota.</p>
<p>È particolarmente adatto a reparti IT interni, consulenti e MSP che gestiscono più clienti e vogliono eliminare i costi di licenza senza rinunciare alle funzionalità.</p>
<p>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.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-meshcentral-su-ubuntu-server-26-04/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04</title>
		<link>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-faraday-su-ubuntu-server-26-04/</link>
					<comments>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-faraday-su-ubuntu-server-26-04/#respond</comments>
		
		<dc:creator><![CDATA[Raffaele Chiatto]]></dc:creator>
		<pubDate>Mon, 16 Nov 2026 07:36:47 +0000</pubDate>
				<category><![CDATA[Faraday]]></category>
		<category><![CDATA[Ubuntu]]></category>
		<category><![CDATA[faraday]]></category>
		<category><![CDATA[nis2]]></category>
		<category><![CDATA[Security]]></category>
		<guid isPermaLink="false">https://www.raffaelechiatto.com/?p=1125293</guid>

					<description><![CDATA[&#160; &#160; Chi si occupa di sicurezza informatica conosce bene il problema: i vulnerability assessment e i penetration test producono una grande quantità di risultati, sparsi tra gli output di strumenti diversi come Nmap, OpenVAS, Nessus, Burp Suite o Nuclei. Ognuno ha il suo formato, i suoi livelli di severità e le sue duplicazioni. Mettere [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img loading="lazy" decoding="async" class="size-full wp-image-1091058 alignnone" src="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png" alt="Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 - Raffaele Chiatto" width="679" height="89" title="Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 12" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png 679w, https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR-480x63.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 679px, 100vw" /></p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>Chi si occupa di sicurezza informatica conosce bene il problema: i vulnerability assessment e i penetration test producono una grande quantità di risultati, sparsi tra gli output di strumenti diversi come Nmap, OpenVAS, Nessus, Burp Suite o Nuclei.</p>
<p>Ognuno ha il suo formato, i suoi livelli di severità e le sue duplicazioni.</p>
<p>Mettere ordine in questi dati, capire quali vulnerabilità sono davvero rilevanti e seguirne la risoluzione nel tempo diventa presto un lavoro a sé, soprattutto per chi deve dimostrare un processo strutturato di gestione delle vulnerabilità secondo NIS2 o ISO 27001.</p>
<p>Faraday è una piattaforma open source di vulnerability management nata proprio per risolvere questo problema.</p>
<p>Importa e normalizza i risultati di decine di strumenti di sicurezza in un’unica interfaccia web e organizza il lavoro in workspace, per cliente, progetto o perimetro.</p>
<p>Consente inoltre di filtrare, deduplicare e assegnare priorità alle vulnerabilità, di seguirne lo stato fino alla chiusura e di collaborare sullo stesso assessment.</p>
<p>Grazie alla sua API e ai plugin si integra facilmente in pipeline e processi già esistenti.</p>
<p>In questo articolo vediamo come installare la versione Community di Faraday su Ubuntu Server 26.04 LTS usando il pacchetto .deb ufficiale.</p>
<p>Partiamo dalla preparazione del sistema e dei prerequisiti, passiamo all’inizializzazione del database e all’avvio dei servizi, e arriviamo alla pubblicazione dell’interfaccia web dietro un reverse proxy Nginx in HTTPS.</p>
<p>Lungo il percorso affronteremo anche un paio di problemi concreti che si incontrano installando Faraday sulla nuova release di Ubuntu: una dipendenza non più disponibile nei repository e una configurazione di Nginx che, se scritta male, blocca il login.</p>
<p>&nbsp;</p>
<h3><strong>INTRODUZIONE</strong></h3>
<p><strong>NOTA SULLA COMPATIBILITÀ</strong>: la documentazione ufficiale certifica Ubuntu 22.04 e 24.04 LTS, Debian 12+ e Kali. Ubuntu 26.04 non è ancora nell&#8217;elenco; il pacchetto .deb è autocontenuto e i passaggi sono gli stessi, ma conviene testare prima su una VM non di produzione.</p>
<p>Componenti installati:</p>
<table style="height: 138px; width: 100%; border-style: solid;" border="2" width="100%">
<thead>
<tr style="height: 23px;">
<th style="height: 23px;" scope="col">Componente</th>
<th style="height: 23px;" scope="col">Ruolo</th>
<th style="height: 23px;" scope="col">Porta</th>
</tr>
</thead>
<tbody>
<tr style="height: 23px;">
<td style="height: 23px;">PostgreSQL</td>
<td style="height: 23px;">Database dei workspace e delle vulnerabilità</td>
<td style="height: 23px;">5432 (solo locale)</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;">Redis</td>
<td style="height: 23px;">Coda e cache per i worker Celery</td>
<td style="height: 23px;">6379 (solo locale)</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;">faraday-server</td>
<td style="height: 23px;">API e interfaccia web</td>
<td style="height: 23px;"><span dir="ltr">5985</span></td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px; border-style: solid;">faraday-worker, faraday-worker-reports, faraday-beat</td>
<td style="height: 23px;">Elaborazione asincrona, import dei report, task schedulati</td>
<td style="height: 23px;">–</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;">Nginx</td>
<td style="height: 23px;">Reverse proxy con TLS</td>
<td style="height: 23px;"><span dir="ltr">443</span></td>
</tr>
</tbody>
</table>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>PREREQUISITI</strong></h3>
<p>Serve un Ubuntu Server 26.04 a 64 bit (amd64) con accesso sudo, almeno 2 vCPU, 4 GB di RAM e 20 GB di disco liberi. Per lavorare con report grandi meglio 8 GB di RAM.</p>
<p>1. Aggiorna il sistema e installa gli strumenti di base:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt update &amp;&amp; sudo apt full-upgrade -y
sudo apt install -y curl wget ca-certificates gnupg ufw</pre><p>2. Imposta hostname e fuso orario (esempio):</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo hostnamectl set-hostname faraday.example.local
sudo timedatectl set-timezone Europe/Rome</pre><p>3. Configura il firewall lasciando aperti solo SSH e HTTP/HTTPS (la porta 5985 resta chiusa: ci arriverà solo Nginx):</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI POSTGRESQL E REDIS</strong></h3>
<p>Faraday richiede PostgreSQL 12+ (consigliato 14+) e Redis 6.0+ (consigliato 7.x): le versioni nei repository di Ubuntu 26.04 sono ampiamente sopra il minimo.</p>
<p>4. Installa e abilita entrambi i servizi:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y postgresql redis-server
sudo systemctl enable --now postgresql redis-server</pre><p>5. Verifica che rispondano:</p><pre class="urvanov-syntax-highlighter-plain-tag">pg_isready</pre><p>Dovremmo visualizzare l&#8217;output seguente:</p><pre class="urvanov-syntax-highlighter-plain-tag">/var/run/postgresql:5432 - accepting connections</pre><p>Eseguire il comando:</p><pre class="urvanov-syntax-highlighter-plain-tag">redis-cli ping</pre><p>Dovremmo visualizzare l&#8217;output seguente:</p><pre class="urvanov-syntax-highlighter-plain-tag">PONG</pre><p>&nbsp;</p>
<p>6. Controlla che il database usi la codifica UTF-8 (in caso contrario initdb fallisce, vedi Troubleshooting):</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo -u postgres psql -c "SHOW SERVER_ENCODING;"</pre><p>Entrambi i servizi ascoltano solo su localhost per impostazione predefinita: non vanno esposti all&#8217;esterno.</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI FARADAY SERVER (.DEB)</strong></h3>
<p>La Community Edition si scarica dalla pagina Releases di GitHub (https://github.com/infobyte/faraday/releases); il pacchetto si chiama faraday-server_amd64.deb.</p>
<p>7. Scarica il pacchetto. Copia il link esatto dell&#8217;asset .deb dalla release più recente (al momento v5.25.4) e usalo con wget:</p><pre class="urvanov-syntax-highlighter-plain-tag">cd /tmp
wget -O faraday-server_amd64.deb https://github.com/infobyte/faraday/releases/download/v5.25.4/faraday-server_ubuntu24_amd64.deb</pre><p>Quindi creare il pacchetto ponte coin i seguenti comandi:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y equivs libgdk-pixbuf-2.0-0
cd /tmp
cat &gt; libgdk-pixbuf2.0-0-compat &lt;&lt;'EOF'
Package: libgdk-pixbuf2.0-0
Version: 2.42.99-compat
Depends: libgdk-pixbuf-2.0-0
Architecture: all
Description: Pacchetto di transizione per compatibilità con faraday-server
EOF
equivs-build libgdk-pixbuf2.0-0-compat
sudo apt install -y ./libgdk-pixbuf2.0-0_2.42.99-compat_all.deb
sudo apt install -y ./faraday-server_amd64.deb</pre><p>&nbsp;</p>
<p>8. Installa con apt, che risolve automaticamente le dipendenze:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y ./faraday-server_amd64.deb</pre><p>9. Aggiungi il tuo utente al gruppo faraday creato dal pacchetto, poi esci e rientra (o usa newgrp) per applicare il gruppo:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo usermod -aG faraday $USER
newgrp faraday</pre><p>Il pacchetto crea l&#8217;utente di sistema faraday, i comandi faraday-manage e le unit systemd. Il file di configurazione è /home/faraday/.faraday/config/server.ini.</p>
<p>&nbsp;</p>
<h3><strong>INIZIALIZZAZIONE DEL DATABASE E UTENTE ADMIN</strong></h3>
<p>faraday-manage initdb crea utente e database PostgreSQL, applica le migrazioni e genera l&#8217;utente faraday (admin) con una password casuale mostrata una sola volta.</p>
<p>10. Lancia l&#8217;inizializzazione:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo faraday-manage initdb</pre><p>Dovremmo visualizzare il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">Admin user created with

username: faraday
password: 7Tr8Pm3b8jBZ</pre><p>&nbsp;</p>
<p>11. Copia subito la password stampata a fine output e salvala nel password manager. Se la perdi, reimpostala con:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo faraday-manage change-password</pre><p>Per creare altri amministratori: sudo faraday-manage create-superuser</p>
<p>&nbsp;</p>
<h3><strong>AVVIO DEI SERVIZI E PRIMO ACCESSO</strong></h3>
<p>Faraday gira come quattro unit systemd: senza i worker la UI si apre ma l&#8217;import dei report resta bloccato.</p>
<p>12. Abilita e avvia tutti i servizi:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo systemctl enable --now faraday-server faraday-worker faraday-beat</pre><p>13. Verifica lo stato e che il server risponda sulla 5985:</p><pre class="urvanov-syntax-highlighter-plain-tag">systemctl status faraday-server faraday-worker faraday-worker-reports faraday-beat --no-pager
ss -tlnp | grep 5985
curl -s http://localhost:5985/_api/config | head -c 200</pre><p>14. Accedi dalla tua postazione con un tunnel SSH (la 5985 ascolta solo su localhost) e apri http://localhost:5985 nel browser, utente faraday e la password dello step 11:</p><pre class="urvanov-syntax-highlighter-plain-tag">ssh -L 5985:localhost:5985 utente@ip-server</pre><p>Per l&#8217;accesso permanente da rete si usa Nginx (sezione successiva). Sconsigliato invece impostare bind_address = 0.0.0.0 in server.ini: esporrebbe l&#8217;API in HTTP in chiaro.</p>
<p>&nbsp;</p>
<h3><strong>PUBBLICAZIONE DIETRO NGINX CON HTTPS</strong></h3>
<p>Faraday non gestisce TLS da sé: la documentazione ufficiale raccomanda un reverse proxy davanti alla 5985.</p>
<p>15. Installa Nginx:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y nginx</pre><p>16. Prepara il certificato. Per un server raggiungibile da Internet usa Let&#8217;s Encrypt:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d faraday.example.com</pre><p>In LAN usa un certificato della CA interna oppure, per test, uno self-signed:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo openssl req -x509 -nodes -days 825 -newkey rsa:4096 \
-keyout /etc/ssl/private/faraday.key \
-out /etc/ssl/certs/faraday.crt \
-subj "/CN=faraday.example.local" \
-addext "subjectAltName=DNS:faraday.example.local"</pre><p>&nbsp;</p>
<p>17. Crea il virtual host. Faraday può generarne uno di base con</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo faraday-manage generate-nginx-config; in alternativa crea /etc/nginx/sites-available/faraday con il comando:

sudo nano /etc/nginx/sites-available/faraday</pre><p>Quindi incollare all&#8217;interno il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">server {
listen 80;
server_name faraday.example.local;
return 301 https://$host$request_uri;
}

server {
listen 443 ssl;
http2 on;
server_name faraday.example.local;

ssl_certificate /etc/ssl/certs/faraday.crt;
ssl_certificate_key /etc/ssl/private/faraday.key;
ssl_protocols TLSv1.2 TLSv1.3;

client_max_body_size 500M; # import di report grandi

location / {
proxy_pass http://127.0.0.1:5985;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade; # websocket
proxy_set_header Connection "upgrade";
proxy_read_timeout 300s;
}
}</pre><p>&nbsp;</p>
<p>18. Abilita il sito e ricarica Nginx:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo ln -s /etc/nginx/sites-available/faraday /etc/nginx/sites-enabled/
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t &amp;&amp; sudo systemctl reload nginx</pre><p>Ora Faraday risponde su https://faraday.example.local (crea il record DNS o la voce in hosts).</p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-01.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125306 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-01-1024x573.png" alt="Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="573" title="Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 13" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-01-980x548.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-01-480x268.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Inserire le credenziali generate in precedenza e cliccare <strong>Login</strong></p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-02.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125307 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-02-1024x571.png" alt="Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="571" title="Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 14" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-02-980x546.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-faraday-ubuntu-02-480x268.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Se è andato tutto a buon fine dovremmo visualizzare la <strong>Dashboard di Faraday</strong></p>
<p>&nbsp;</p>
<h3><strong>METODO ALTERNATIVO DI INSTALLAZIONE: DOCKER COMPOSE</strong></h3>
<p>Se preferisci non installare nulla sull&#8217;host oltre a Docker, il file Compose ufficiale avvia PostgreSQL, Redis, server, worker e beat in un colpo solo. Salta gli step 4-14 e segui questi.</p>
<p>A. Installa Docker Engine e il plugin Compose v2 dai repository di Ubuntu:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y docker.io docker-compose-v2
sudo usermod -aG docker $USER &amp;&amp; newgrp docker
docker compose version</pre><p>B. Scarica il file Compose ufficiale:</p><pre class="urvanov-syntax-highlighter-plain-tag">mkdir -p ~/faraday &amp;&amp; cd ~/faraday
wget https://raw.githubusercontent.com/infobyte/faraday/master/docker-compose.yaml</pre><p>C. Prima di avviare, sostituisci in docker-compose.yaml la password &#8220;postgres&#8221; di default (compare in POSTGRES_PASSWORD e in tutti i PGSQL_PASSWD) con una password robusta.</p>
<p>D. Avvia lo stack e inizializza il database (annota la password admin stampata):</p><pre class="urvanov-syntax-highlighter-plain-tag">docker compose up -d
docker compose run --rm faraday-manage initdb
docker compose ps</pre><p>Il server è pubblicato su 0.0.0.0:5985. Per esporlo solo a Nginx cambia la riga &#8220;ports&#8221; del servizio faraday-server in &#8220;127.0.0.1:5985:5985&#8221;, poi applica la sezione Nginx dagli step 15-18. Attenzione: Docker scrive regole iptables proprie e una porta pubblicata scavalca UFW.</p>
<p>Per aggiornare:</p><pre class="urvanov-syntax-highlighter-plain-tag">docker compose pull &amp;&amp; docker compose up -d</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DEL CLIENT FARADAY-CLI</strong></h3>
<p>faraday-cli permette di lanciare scanner e caricare report da terminale. Su Ubuntu 26.04 pip non installa pacchetti a livello di sistema (PEP 668), quindi si usa pipx.</p>
<p>19. Installa il client sulla macchina da cui fai gli scan:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y pipx
pipx ensurepath &amp;&amp; source ~/.bashrc
pipx install faraday-cli</pre><p>&nbsp;</p>
<p>20. Autenticati, crea un workspace e importa un primo risultato:</p><pre class="urvanov-syntax-highlighter-plain-tag">faraday-cli auth -f https://faraday.example.local -u faraday -p '&lt;password&gt;'
faraday-cli workspace create test-lab
faraday-cli tool run "nmap -sV 192.168.1.0/24"
faraday-cli tool report /percorso/scan_nessus.nessus</pre><p>Con un certificato self-signed aggiungi &#8211;ignore-ssl al comando auth.</p>
<p>&nbsp;</p>
<h3><strong>TROUBLESHOOTING E COMANDI UTILI</strong></h3>
<p><strong>Sintomo</strong>: initdb fallisce per permessi<br />
<strong>Causa</strong>: l&#8217;utente faraday non può creare database<br />
<strong>Fix</strong>: sudo -u postgres psql -c &#8220;ALTER USER faraday CREATEDB;&#8221;</p>
<p><strong>Sintomo</strong>: initdb: encoding UTF8 incompatibile con template (SQL_ASCII)<br />
<strong>Causa</strong>: template1 creato senza UTF-8<br />
<strong>Fix:</strong> ricrea template1 in UTF-8 (SQL sotto), poi ripeti initdb</p>
<p><strong>Sintomo</strong>: report caricati ma mai elaborati<br />
<strong>Causa</strong>: Redis o worker fermi<br />
<strong>Fix</strong>: redis-cli ping, poi sudo systemctl restart faraday-worker faraday-worker-reports</p>
<p><strong>Sintomo</strong>: 413 Request Entity Too Large in import<br />
<strong>Causa</strong>: limite upload di Nginx<br />
<strong>Fix</strong>: alza client_max_body_size e ricarica Nginx</p>
<p><strong>Sintomo</strong>: 502 Bad Gateway da Nginx<br />
<strong>Causa</strong>: faraday-server non in ascolto<br />
<strong>Fix</strong>: systemctl status faraday-server e controlla i log</p>
<p><strong>Sintomo</strong>: Docker, porta 5985 o 5432 occupata<br />
<strong>Causa</strong>: conflitto con servizi locali<br />
<strong>Fix</strong>: ss -tlnp | grep -E &#8216;5985|5432&#8217;</p>
<p>Ricreare template1 in UTF-8:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo -u postgres psql &lt;&lt;'SQL'
UPDATE pg_database SET datistemplate = FALSE WHERE datname = 'template1';
DROP DATABASE template1;
CREATE DATABASE template1 WITH TEMPLATE = template0 ENCODING = 'UTF8';
UPDATE pg_database SET datistemplate = TRUE WHERE datname = 'template1';
SQL</pre><p>Comandi utili:</p><pre class="urvanov-syntax-highlighter-plain-tag"># log applicativi
sudo ls /home/faraday/.faraday/logs/
sudo journalctl -u faraday-server -f</pre><p>&nbsp;</p><pre class="urvanov-syntax-highlighter-plain-tag"># console SQL sul database di Faraday
sudo faraday-manage sql-shell</pre><p>&nbsp;</p><pre class="urvanov-syntax-highlighter-plain-tag"># aggiornamento: installa il nuovo .deb e riavvia i servizi
sudo apt install -y ./faraday-server_amd64.deb
sudo systemctl restart faraday-server faraday-worker faraday-worker-reports faraday-beat</pre><p>&nbsp;</p><pre class="urvanov-syntax-highlighter-plain-tag"># backup del database
sudo -u postgres pg_dump -Fc faraday &gt; faraday_$(date +%F).dump</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>CONSIDERAZIONI FINALI</strong></h3>
<p>Con questa guida abbiamo installato Faraday Community su Ubuntu Server 26.04 LTS e l’abbiamo pubblicato dietro un reverse proxy Nginx in HTTPS.</p>
<p>Ne risulta una piattaforma pronta per raccogliere in un unico punto i risultati dei vulnerability assessment.</p>
<p>Il percorso non è stato del tutto lineare: il pacchetto ufficiale non è ancora pensato per la nuova release di Ubuntu e la configurazione del reverse proxy nasconde una trappola. Una volta superati questi due ostacoli, però, Faraday si è dimostrato stabile e semplice da usare.</p>
<h4><strong>PRO</strong></h4>
<ul>
<li>Open source e self-hosted: i dati sulle vulnerabilità, che sono tra le informazioni più sensibili di un’organizzazione, restano sui propri server.</li>
<li>Centralizzazione dei risultati: importa e normalizza gli output di molti strumenti diversi (Nmap, OpenVAS, Nessus, Burp Suite, Nuclei e altri) in un’unica vista.</li>
<li>Organizzazione in workspace: permette di separare clienti, progetti o perimetri. È comodo per chi lavora come MSP o consulente.</li>
<li>Gestione del ciclo di vita delle vulnerabilità: stati, severità, filtri e deduplica aiutano a passare dal semplice elenco di finding a un vero processo di remediation.</li>
<li>API e plugin: si integra facilmente in pipeline CI/CD e con altri strumenti, anche da riga di comando.</li>
<li>Supporto alla compliance: offre uno storico tracciabile delle vulnerabilità e della loro gestione, utile come evidenza per NIS2 e ISO 27001.</li>
</ul>
<p>&nbsp;</p>
<h4><strong>CONTRO</strong></h4>
<ul>
<li>Pacchetto .deb non aggiornato per Ubuntu 26.04: richiede un workaround per la dipendenza libgdk-pixbuf2.0-0, non più presente nei repository.</li>
<li>Stack tecnico un po’ datato: i warning di deprecazione (pkg_resources, bcrypt) indicano dipendenze Python non allineate alle versioni più recenti.</li>
<li>Reverse proxy da configurare con attenzione: un Connection &#8220;upgrade&#8221; applicato a tutte le richieste blocca il login senza messaggi d’errore chiari.</li>
<li>Credenziali mostrate una sola volta: la password dell’amministratore viene generata durante l’initdb e, se non la si annota, va reimpostata.</li>
<li>Funzionalità avanzate a pagamento: reportistica personalizzata, workflow automatizzati, integrazioni enterprise e autenticazione centralizzata sono riservate alle edizioni commerciali.</li>
<li>Documentazione non sempre aggiornata: alcune indicazioni, come i nomi dei servizi systemd, non corrispondono alla versione installata.</li>
</ul>
<p>&nbsp;</p>
<p>In conclusione, Faraday Community è un’ottima base per chi vuole smettere di gestire le vulnerabilità con fogli Excel e cartelle di report sparse e passare a uno strumento strutturato e centralizzato.</p>
<p>Per un laboratorio, un piccolo team di sicurezza o un consulente che segue più clienti, la versione gratuita offre già molto. Chi ha bisogno di reportistica avanzata, automazione e integrazione con l’autenticazione aziendale dovrà invece valutare le edizioni commerciali o affiancare altri strumenti.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-faraday-su-ubuntu-server-26-04/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04</title>
		<link>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-netpicker-su-ubuntu-server-26-04/</link>
					<comments>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-netpicker-su-ubuntu-server-26-04/#respond</comments>
		
		<dc:creator><![CDATA[Raffaele Chiatto]]></dc:creator>
		<pubDate>Wed, 11 Nov 2026 11:48:41 +0000</pubDate>
				<category><![CDATA[Ubuntu]]></category>
		<category><![CDATA[Netpicker]]></category>
		<category><![CDATA[backup]]></category>
		<category><![CDATA[Docker]]></category>
		<category><![CDATA[network]]></category>
		<guid isPermaLink="false">https://www.raffaelechiatto.com/?p=1125278</guid>

					<description><![CDATA[&#160; Chi gestisce un’infrastruttura di rete lo sa bene: switch, router e firewall cambiano configurazione più spesso di quanto si pensi, e quasi sempre ce ne si accorge solo quando qualcosa smette di funzionare. Avere un backup aggiornato delle configurazioni, sapere chi ha modificato cosa e verificare che ogni apparato rispetti le policy aziendali non [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img loading="lazy" decoding="async" class="size-full wp-image-1091058 alignnone" src="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png" alt="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 - Raffaele Chiatto" width="679" height="89" title="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 19" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png 679w, https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR-480x63.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 679px, 100vw" /></p>
<p>&nbsp;</p>
<p>Chi gestisce un’infrastruttura di rete lo sa bene: switch, router e firewall cambiano configurazione più spesso di quanto si pensi, e quasi sempre ce ne si accorge solo quando qualcosa smette di funzionare.</p>
<p>Avere un backup aggiornato delle configurazioni, sapere chi ha modificato cosa e verificare che ogni apparato rispetti le policy aziendali non è più un lusso, ma un requisito, soprattutto in contesti soggetti a normative come NIS2 o ISO 27001.</p>
<p>Netpicker è una piattaforma pensata proprio per questo. Esegue il backup automatico delle configurazioni degli apparati di rete di molti vendor diversi, ne conserva lo storico in un repository Git e permette di confrontare le versioni.</p>
<p>Consente inoltre di definire regole di compliance da verificare su tutti i dispositivi e di automatizzare le attività ripetitive.</p>
<p>Il tutto si gestisce da un’interfaccia web semplice e si distribuisce come stack Docker, quindi si può installare in pochi minuti su un normale server Linux.</p>
<p>In questo articolo vediamo passo passo come installare Netpicker su Ubuntu Server 26.04 LTS: dalla preparazione del sistema e del firewall all’installazione di Docker Engine e Docker Compose, fino al download del progetto, alla sua configurazione di base e al primo avvio dei container.</p>
<p>Vedremo anche come verificare che tutto funzioni e come risolvere un paio di problemi comuni che si possono incontrare durante l’installazione.</p>
<p>&nbsp;</p>
<h3><strong>PREREQUISITI</strong></h3>
<p>Serve una VM Ubuntu Server 26.04 LTS (amd64) con accesso a Internet e un utente con privilegi sudo.</p>
<p>Netpicker non pubblica requisiti hardware ufficiali; i valori sotto sono indicativi per lo stack completo (circa 15 container).</p>
<table style="height: 100%; width: 100%; border-style: solid;" border="2">
<thead>
<tr>
<th scope="col">Risorsa</th>
<th scope="col">Minimo (lab)</th>
<th scope="col">Consigliato (produzione)</th>
</tr>
</thead>
<tbody>
<tr>
<td>vCPU</td>
<td><span dir="ltr">2</span></td>
<td><span dir="ltr">4</span></td>
</tr>
<tr>
<td>RAM</td>
<td>4 GB</td>
<td>8 GB</td>
</tr>
<tr>
<td>Disco</td>
<td>20 GB</td>
<td>100 GB</td>
</tr>
</tbody>
</table>
<p>&nbsp;</p>
<p>Porte usate dallo stack:</p>
<table style="height: 100%; width: 100%; border-style: solid;" border="2">
<thead>
<tr style="height: 23px;">
<th style="height: 23px;" scope="col">Porta</th>
<th style="height: 23px;" scope="col">Protocollo</th>
<th style="height: 23px;" scope="col">Servizio</th>
</tr>
</thead>
<tbody>
<tr style="height: 23px;">
<td style="height: 23px;"><span dir="ltr">80</span></td>
<td style="height: 23px;">TCP</td>
<td style="height: 23px;">Interfaccia web (frontend)</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;"><span dir="ltr">8000</span></td>
<td style="height: 23px;">TCP</td>
<td style="height: 23px;">API REST</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;"><span dir="ltr">5514</span></td>
<td style="height: 23px;">UDP</td>
<td style="height: 23px;">Syslog dagli apparati</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;">6601 / 6514</td>
<td style="height: 23px;">TCP</td>
<td style="height: 23px;">Syslog TCP / TLS</td>
</tr>
<tr style="height: 23px;">
<td style="height: 23px;"><span dir="ltr">9418</span></td>
<td style="height: 23px;">TCP</td>
<td style="height: 23px;">Git daemon (non esposto di default, opzionale)</td>
</tr>
</tbody>
</table>
<p>&nbsp;</p>
<p>Il server deve poter raggiungere gli apparati in SSH/Telnet e per l&#8217;installazione, github.com, download.docker.com e Docker Hub.</p>
<p>&nbsp;</p>
<h3><strong>PREPARAZIONE DEL SISTEMA</strong></h3>
<p>Aggiorna il sistema, imposta hostname e fuso orario e apri solo le porte necessarie.</p>
<p>Aggiorna i pacchetti e installa gli strumenti di base:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt update &amp;&amp; sudo apt full-upgrade -y
sudo apt install -y git curl ca-certificates</pre><p>Imposta hostname e fuso orario (adatta i valori):</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo hostnamectl set-hostname netpicker
sudo timedatectl set-timezone Europe/Rome</pre><p>Configura UFW, consentendo SSH prima di attivarlo:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 5514/udp
sudo ufw enable</pre><p><strong>ATTENZIONE:</strong> Docker pubblica le porte scrivendo direttamente in iptables, quindi le porte mappate dai container (es. 8000) restano raggiungibili anche se UFW non le consente. Se vuoi limitarle, filtra a monte (firewall perimetrale) o usa la catena DOCKER-USER.</p>
<p>Riavvia se è stato aggiornato il kernel: sudo reboot.</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI DOCKER ENGINE E DOCKER COMPOSE</strong></h3>
<p>Usa il repository ufficiale Docker, che supporta Ubuntu 26.04 &#8220;Resolute&#8221;; evita il pacchetto docker.io di Ubuntu e lo snap.</p>
<p>Rimuovi eventuali pacchetti Docker non ufficiali:</p><pre class="urvanov-syntax-highlighter-plain-tag">for pkg in docker.io docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt remove -y $pkg; done</pre><p>Aggiungi chiave GPG e repository:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources &lt;&lt;EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release &amp;&amp; echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF</pre><p>Quindi aggiornare con il comando:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt update</pre><p>Installa Docker Engine e il plugin Compose:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin</pre><p>Abilita il servizio e aggiungi il tuo utente al gruppo docker (poi esci e rientra in SSH):</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo systemctl enable --now docker
sudo usermod -aG docker $USER</pre><p>Verificare Docker con i seguenti comandi:</p><pre class="urvanov-syntax-highlighter-plain-tag">docker version
docker compose version
docker run --rm hello-world</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>DOWNLOAD E CONFIGURAZIONE DI NETPICKER</strong></h3>
<p>Netpicker si distribuisce come repository GitHub con docker-compose.yml e script di gestione (up.sh, down.sh, update.sh, backup.sh, restore.sh).</p>
<p>Clona il repository in /opt:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo mkdir -p /opt/netpicker &amp;&amp; sudo chown $USER:$USER /opt/netpicker
git clone https://github.com/netpicker/netpicker /opt/netpicker
cd /opt/netpicker</pre><p>Verifica il GID del gruppo docker. Il servizio api monta /var/run/docker.sock e nel compose usa il GID 999:</p><pre class="urvanov-syntax-highlighter-plain-tag">getent group docker</pre><p>Dovremmo visualizzare un output simile al seguente:</p><pre class="urvanov-syntax-highlighter-plain-tag">docker:x:983:rchiatto</pre><p>Se il GID non è 999, oppure vuoi personalizzare qualcosa, crea un file override (non viene toccato da git pull durante gli aggiornamenti):</p><pre class="urvanov-syntax-highlighter-plain-tag">cp docker-compose.override.yml.sample docker-compose.override.yml
nano docker-compose.override.yml</pre><p>Esempio da aggiungere sotto services: (sostituisci 988 con il tuo GID; la mappatura 9418 serve solo se vuoi clonare dall&#8217;esterno il repository Git dei backup):</p><pre class="urvanov-syntax-highlighter-plain-tag">cat &gt; docker-compose.override.yml &lt;&lt;'EOF'
services:
api:
group_add:
- "983"
EOF</pre><p>Il file sample contiene anche, commentate, variabili utili come INIT_PASSWORD (password iniziale dell&#8217;admin) e CELERY_CONCURRENCY: decommentale solo se ti servono.</p>
<p>&nbsp;</p>
<h3><strong>AVVIO DEI CONTAINER E VERIFICA</strong></h3>
<p>Avvia lo stack dalla cartella del progetto; il primo avvio scarica le immagini e richiede alcuni minuti.</p>
<p>Avvia Netpicker (lo script esegue docker compose down e poi docker compose up -d):</p><pre class="urvanov-syntax-highlighter-plain-tag">cd /opt/netpicker
bash up.sh</pre><p>Controlla lo stato: tutti i servizi devono risultare running o healthy, mentre db_migration termina con exited (0) ed è normale.</p><pre class="urvanov-syntax-highlighter-plain-tag">docker compose ps</pre><p>Verifica l&#8217;API e il frontend:</p><pre class="urvanov-syntax-highlighter-plain-tag">curl -s http://localhost:8000/api/v1/status</pre><p>Dovremmo visualizzare il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">{"Meta":{"host":"localhost:8000","user-agent":"curl/8.18.0","accept":"*/*","x-request-id":"ce7d36ad27a54819a63714b3ae4e4cfa"},"api_base":"http://localhost:8000/","tz":"UTC","scheduler_timezone":"UTC","minio-running":"1"}root@vm-srv-test:/opt/netpicker#</pre><p>Quindi:</p><pre class="urvanov-syntax-highlighter-plain-tag">curl -I http://localhost</pre><p>Dovremmo visualizzare il seguente output:</p><pre class="urvanov-syntax-highlighter-plain-tag">HTTP/1.1 200 OK
Server: nginx/1.27.4
Date: Fri, 06 Nov 2026 21:23:49 GMT
Content-Type: text/html
Content-Length: 8309
Last-Modified: Thu, 08 Oct 2026 09:44:05 GMT
Connection: keep-alive
ETag: "6ac765e5-2075"
Cache-Control: no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0
Pragma: no-cache
Expires: 0
Accept-Ranges: bytes</pre><p>Se un servizio non parte, leggi i log:</p><pre class="urvanov-syntax-highlighter-plain-tag">docker compose logs -f api</pre><p>Dopo un riavvio del server verifica con docker compose ps che lo stack sia ripartito; se non lo è, rilancia bash up.sh.</p>
<p>&nbsp;</p>
<h3><strong>PRIMO ACCESSO E CONFIGURAZIONE INIZIALE</strong></h3>
<p>Apri <strong>http://&lt;IP-del-server&gt;/</strong> dal browser e</p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-01.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125284 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-01-1024x555.png" alt="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="555" title="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 20" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-01-980x531.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-01-480x260.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Accedi con le credenziali predefinite, poi cambia subito la password.</p>
<p><strong>Utente: admin@admin.com</strong><br />
<strong>Password: 12345678</strong></p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-02.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125285 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-02-1024x554.png" alt="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="554" title="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 21" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-02-980x530.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-02-480x259.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Accettare l<strong>&#8216;EULA</strong> quindi cliccare <strong>Continue</strong></p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-03.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125286 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-03-1024x555.png" alt="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="555" title="Installazione e Configurazione Base di Netpicker su Ubuntu Server 26.04 22" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-03-980x531.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/11/inst-netpicker-ubuntu-03-480x260.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Se è andato tutto a buon fine dovremmo visualizzare la Dashboard di Netpicker</p>
<p>&nbsp;</p>
<h3><strong>PASSI CONSIGLIATI DOPO IL PRIMO LOGIN</strong></h3>
<ol>
<li>Cambia la password dell&#8217;amministratore dal profilo utente.</li>
<li>Crea un vault con le credenziali SSH degli apparati: ogni device deve avere un vault associato per potersi collegare.</li>
<li>Aggiungi i dispositivi (singolarmente o da CSV) indicando IP e piattaforma; il valore della piattaforma deve corrispondere al device_type di Netmiko (es. cisco_ios, fortinet), altrimenti il backup fallisce.</li>
<li>Lancia un primo backup e verifica lo storico delle configurazioni e i diff.</li>
<li>Facoltativo: configura gli apparati per inviare syslog al server sulla porta UDP 5514, e l&#8217;autenticazione LDAP/SAML/OAuth seguendo la documentazione di autenticazione (https://github.com/netpicker/netpicker blob/main/docs/authentication/README.md).</li>
</ol>
<p>Per l&#8217;uso in produzione pubblica l&#8217;interfaccia in HTTPS: il repository include nginx-ssl.conf e la cartella certs come base, oppure metti Netpicker dietro un reverse proxy esistente.</p>
<p>&nbsp;</p>
<h3><strong>MANUTENZIONE: AGGIORNAMENTO, BACKUP E TROUBLESHOOTING</strong></h3>
<p>Tutte le operazioni si eseguono da /opt/netpicker con gli script inclusi nel repository; fai sempre un backup prima di aggiornare.</p>
<p>Backup. backup.sh ferma lo stack e salva tutti i volumi netpicker_* in netpicker_backup.tar nella cartella corrente (file di proprietà di root). Lo stack non riparte da solo:</p><pre class="urvanov-syntax-highlighter-plain-tag">bash backup.sh
sudo mv netpicker_backup.tar /backup/netpicker_$(date +%F).tar
bash up.sh</pre><p>Per il ripristino usa restore.sh con lo stesso archivio.</p>
<p>Aggiornamento. update.sh esegue docker compose down, salva una copia di docker-compose.yml, fa git pull, scarica le nuove immagini e riavvia lo stack:</p><pre class="urvanov-syntax-highlighter-plain-tag">bash update.sh
docker image prune -f</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>PROBLEMI COMUNI</strong></h3>
<ul>
<li>permission denied su /var/run/docker.sock nei log di api | GID del gruppo docker diverso da 999 | Imposta il GID corretto in group_add nell&#8217;override (sezione 3)</li>
<li>Errori di scrittura su policy, secret o git | Permessi errati sui volumi | bash fix-volume-permissions.sh (riporta i volumi all&#8217;UID/GID 911)</li>
<li>Interfaccia web non raggiungibile subito dopo l&#8217;avvio | Container ancora in avvio | Attendi qualche minuto e controlla docker compose ps</li>
<li>Backup del device fallito | Piattaforma errata o vault mancante | Usa il device_type Netmiko corretto e associa un vault</li>
<li>Clone del repository Git dei backup non funziona | Porta 9418 non esposta | Aggiungi la mappatura 9418:9418 al servizio gitd</li>
</ul>
<p>&nbsp;</p>
<h3><strong>FUNZIONALITA&#8217; &#8211; PRO E CONTRO</strong></h3>
<h4></h4>
<h4><strong>Funzionalità principali</strong></h4>
<ul>
<li>Backup delle configurazioni: salva in automatico le configurazioni degli apparati e ne tiene lo storico in un repository Git, con confronto tra versioni (diff) e ricerca nelle configurazioni.</li>
<li>Supporto multi-vendor: dichiara compatibilità con oltre 150-180 vendor (Cisco, Fortinet, HP/Aruba, Juniper, MikroTik e altri).</li>
<li>Compliance e testing: le regole si scrivono in Python/pytest e danno esito pass/fail per ogni dispositivo. Servono a verificare hardening, policy e drift della configurazione.</li>
<li>Automazione: job semplici o in Python, remediation delle non conformità, ripristino della configurazione da file e upgrade dell’OS (quest’ultimo è un add-on).</li>
<li>Sicurezza: scansione delle vulnerabilità (CVE) degli apparati con il modulo CVEasy.</li>
<li>Assistente AI: genera regole, job e analisi delle configurazioni a partire da prompt in linguaggio naturale.</li>
<li>Integrazioni: API REST completa e plugin per NetBox, Nautobot, Infrahub e Slurp’it.</li>
<li>Deployment: container Docker on-premise. Kubernetes e ambienti air-gapped sono previsti solo nella versione Enterprise.</li>
</ul>
<h4></h4>
<h4><strong>Pro</strong></h4>
<ul>
<li>La versione gratuita è utile davvero: backup, diff e automazione senza limite di dispositivi.</li>
<li>È self-hosted, quindi le configurazioni restano in casa. È un punto importante per NIS2 e ISO 27001.</li>
<li>Lo storico su Git fornisce una traccia di audit e permette di vedere chi ha cambiato cosa.</li>
<li>Le regole di compliance sono in Python: flessibili e versionabili.</li>
<li>Si installa in pochi minuti con Docker Compose.</li>
<li>Si integra con NetBox e Nautobot come source of truth.</li>
</ul>
<h4></h4>
<h4><strong>Contro</strong></h4>
<ul>
<li>Nella versione gratuita la compliance, la remediation e la scansione CVE funzionano solo su 10 dispositivi, mentre sono proprio le funzioni più interessanti per chi deve dimostrare conformità.</li>
<li>La versione gratuita ammette un solo utente: non va bene se ci lavora un team.</li>
<li>RBAC, SSO e audit log sono disponibili solo nella versione Enterprise, che costa parecchio.</li>
<li>La multi-tenancy per MSP è un add-on a pagamento: è un limite se vuoi gestire più clienti separati.</li>
<li>Lo stack è pesante, con circa 15 container. Mancano requisiti hardware ufficiali e la documentazione è frammentata.</li>
<li>Il syslog integrato è elencato tra le funzioni Enterprise, anche se il container syslog-ng è presente nello stack gratuito.</li>
<li>Scrivere regole in pytest richiede un minimo di competenze di programmazione.</li>
</ul>
<p>In sintesi, per un uso di laboratorio o per backup e versionamento delle configurazioni di una singola realtà la versione Foundation è ottima.</p>
<p>Per un MSP multi-cliente, o se ti serve la compliance su tutto il parco apparati, bisogna mettere in conto la licenza Professional più l’add-on multi-tenancy.</p>
<p>In alternativa conviene confrontarlo con soluzioni come Oxidized + Git (solo backup) o rConfig.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-netpicker-su-ubuntu-server-26-04/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>ChatGPT: Come spostare la cronologia di Codex da un PC a un altro con le dovute precauzioni</title>
		<link>https://www.raffaelechiatto.com/chatgpt-come-spostare-la-cronologia-di-codex-da-un-pc-a-un-altro-con-le-dovute-precauzioni/</link>
					<comments>https://www.raffaelechiatto.com/chatgpt-come-spostare-la-cronologia-di-codex-da-un-pc-a-un-altro-con-le-dovute-precauzioni/#respond</comments>
		
		<dc:creator><![CDATA[Raffaele Chiatto]]></dc:creator>
		<pubDate>Mon, 09 Nov 2026 07:32:37 +0000</pubDate>
				<category><![CDATA[ChatGPT]]></category>
		<category><![CDATA[AI]]></category>
		<category><![CDATA[Codex]]></category>
		<guid isPermaLink="false">https://www.raffaelechiatto.com/?p=1125209</guid>

					<description><![CDATA[&#160; Chi usa Codex, l’agente di programmazione di OpenAI, lo sa: col tempo la cronologia delle sessioni diventa una piccola miniera d’oro. Dentro ci sono conversazioni, ragionamenti, comandi eseguiti, soluzioni a problemi che magari abbiamo risolto settimane fa e che oggi ci tornerebbero utili. Il problema arriva quando bisogna cambiare macchina: un PC nuovo, una [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img loading="lazy" decoding="async" class="size-full wp-image-1091056 alignnone" src="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/INTERMEDIATE-BAR.png" alt="ChatGPT: Come spostare la cronologia di Codex da un PC a un altro con le dovute precauzioni - Raffaele Chiatto" width="679" height="89" title="ChatGPT: Come spostare la cronologia di Codex da un PC a un altro con le dovute precauzioni 24" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/INTERMEDIATE-BAR.png 679w, https://www.raffaelechiatto.com/wp-content/uploads/2020/12/INTERMEDIATE-BAR-480x63.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 679px, 100vw" /></p>
<p>&nbsp;</p>
<p>Chi usa Codex, l’agente di programmazione di OpenAI, lo sa: col tempo la cronologia delle sessioni diventa una piccola miniera d’oro.</p>
<p>Dentro ci sono conversazioni, ragionamenti, comandi eseguiti, soluzioni a problemi che magari abbiamo risolto settimane fa e che oggi ci tornerebbero utili.</p>
<p>Il problema arriva quando bisogna cambiare macchina: un PC nuovo, una reinstallazione del sistema operativo o semplicemente il passaggio dal portatile alla workstation dell’ufficio.</p>
<p>In questi casi la cronologia non segue automaticamente l’utente, e il rischio è ricominciare da zero.</p>
<p>La buona notizia è che la cronologia di Codex è salvata in locale e si può trasferire su un altro computer.</p>
<p>Quella meno buona è che non basta copiare una cartella e sperare che tutto funzioni.</p>
<p>Nella stessa directory, infatti, possono trovarsi anche file di configurazione e credenziali di autenticazione.</p>
<p>Se vengono spostati con leggerezza, magari passando da una chiavetta USB, da un servizio cloud condiviso o da un archivio non protetto, possono diventare un problema di sicurezza.</p>
<p>A questo si aggiungono possibili differenze di percorsi, versioni del client e sistemi operativi tra le due macchine.</p>
<p>In questo articolo vediamo passo passo come spostare la cronologia di Codex da un PC a un altro in modo sicuro: quali file copiare e quali lasciare dove sono, come fare un backup prima di toccare qualsiasi cosa, come proteggere i dati durante il trasferimento e come verificare che sul nuovo PC tutto funzioni correttamente.</p>
<p>&nbsp;</p>
<h3><strong>COME TRASFERIRE LE CHAT DI CODEX DA UN VECCHIO PC A UNO NUOVO</strong></h3>
<p>Quando si cambia computer, una delle prime esigenze è recuperare le conversazioni e continuare a lavorare sui progetti già avviati.</p>
<p>Per provare a trasferire la cronologia locale di Codex su Windows, si può intervenire sulla cartella <code>.codex</code>, conservando prima una copia dei dati presenti sul nuovo computer.</p>
<p><strong>ATTENZIONE</strong>: La procedura descritta è un tentativo manuale di trasferimento, non una migrazione ufficiale verificata. Il risultato può dipendere dalla versione dell’applicazione e dalla struttura dei file presenti sui due PC.</p>
<p>&nbsp;</p>
<h3><strong>PERCHÉ COPIARE SOLTANTO LA CARTELLA SESSIONS POTREBBE NON BASTARE</strong></h3>
<p>La cronologia potrebbe dipendere da più elementi: oltre alle cartelle delle sessioni, possono essere presenti database e file di indice.</p>
<p>Per questo motivo, il trasferimento della sola cartella <code>sessions</code> potrebbe non essere sufficiente a far comparire tutte le conversazioni nell’app sul nuovo computer.</p>
<p>L’obiettivo è copiare insieme gli elementi indicati di seguito, mantenendo un backup che permetta di tornare alla situazione iniziale.</p>
<h4><strong>1. Chiudere completamente Codex su entrambi i PC</strong></h4>
<p>Prima di copiare qualsiasi file, chiudi l’applicazione sia sul vecchio sia sul nuovo computer.</p>
<p>Controlla anche l’area di notifica di Windows, vicino all’orologio: se Codex è ancora attivo, chiudilo completamente da lì.</p>
<p>Questo passaggio serve a evitare che l’app modifichi i file mentre vengono copiati.</p>
<h4><strong>2. Salvare un backup del nuovo PC</strong></h4>
<p>Sul nuovo computer, premi **Windows + R**, inserisci il percorso seguente e premi Invio:</p>
<p><strong><code>%USERPROFILE%</code></strong></p>
<p>Individua la cartella <code>.codex</code> e creane una copia completa chiamata:</p>
<p><strong><code>.codex-backup-nuovo</code></strong></p>
<p>Verifica che la copia sia terminata prima di proseguire. Questo backup conserva i dati attualmente presenti sul nuovo PC, comprese le conversazioni locali che potrebbero non essere più visibili dopo la sostituzione.</p>
<p><strong>ATTENZIONE</strong>: Non spostare la cartella originale: creane una copia.</p>
<h4><strong>3. Copiare i dati dal vecchio PC</strong></h4>
<p>Sul vecchio computer, apri:</p>
<p><strong><code>%USERPROFILE%\.codex</code></strong></p>
<p>Copia gli elementi seguenti, se presenti:</p>
<ul>
<li>La cartella <code>sessions</code>.</li>
<li>La cartella <code>archived_sessions</code>.</li>
<li>La cartella <code>sqlite</code>.</li>
<li>Tutti i file il cui nome inizia con <code>state_</code>, compresi quelli con suffisso <code>-wal</code> e <code>-shm</code>.</li>
<li>Il file <code>session_index.jsonl</code>.</li>
</ul>
<p>Puoi utilizzare una chiavetta USB, un disco esterno o un altro metodo di trasferimento. Se un elemento non esiste, passa a quello successivo senza creare file o cartelle sostitutivi.</p>
<h4><strong>4. Incollare i dati sul nuovo PC</strong></h4>
<p>Con Codex ancora chiuso, apri sul nuovo computer:</p>
<p><strong><code>%USERPROFILE%\.codex</code></strong></p>
<p>Incolla gli elementi copiati dal vecchio PC, accettando la sostituzione dei file corrispondenti.</p>
<p>Mantieni invece i seguenti elementi già presenti sul nuovo computer:</p>
<ul>
<li><code>auth.json</code></li>
<li><code>config.toml</code></li>
<li>Le cartelle il cui nome inizia con <code>.sandbox</code></li>
</ul>
<p>La procedura prevede quindi il trasferimento selettivo dei dati della cronologia, lasciando sul nuovo PC questi file e cartelle.</p>
<h4><strong>5. Riaprire Codex e controllare le conversazioni</strong></h4>
<p>Avvia Codex e verifica che le chat precedenti compaiano nell’elenco. Apri alcune conversazioni per controllare anche il contenuto.</p>
<p>Le chat create sul nuovo PC prima del trasferimento potrebbero sparire dall’elenco dopo la sostituzione. I relativi dati resteranno nel backup, ma la loro presenza nella copia non garantisce una fusione automatica delle due cronologie.</p>
<h4><strong>Come tornare alla situazione precedente</strong></h4>
<p>Se il risultato non è quello atteso, chiudi completamente Codex. Rinomina la cartella <code>.codex</code> modificata, conservandola, e ripristina al suo posto una copia di <code>.codex-backup-nuovo</code> con il nome <code>.codex</code>.</p>
<p>In questo modo puoi tentare di recuperare lo stato del nuovo PC precedente al trasferimento.</p>
<h3></h3>
<h3><strong>ATTENZIONE A IMMAGINI E FILE DEI PROGETTI</strong></h3>
<p>Il trasferimento della cartella <code>.codex</code> non comprende necessariamente tutti i materiali utilizzati nelle conversazioni.</p>
<p>Immagini, documenti e altri file salvati in percorsi esterni, per esempio in <code>Documents\Codex</code>, richiedono anche la copia delle rispettive cartelle.</p>
<p>Prima di eliminare qualsiasi dato dal vecchio computer, verifica quindi sia le chat sia i materiali collegati. Conserva il backup finché non hai controllato che ciò che ti serve sia accessibile sul nuovo PC.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://www.raffaelechiatto.com/chatgpt-come-spostare-la-cronologia-di-codex-da-un-pc-a-un-altro-con-le-dovute-precauzioni/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>Migrare Claude Code su un nuovo computer chat, impostazioni e server MCP</title>
		<link>https://www.raffaelechiatto.com/migrare-claude-code-su-un-nuovo-computer-chat-impostazioni-e-server-mcp/</link>
					<comments>https://www.raffaelechiatto.com/migrare-claude-code-su-un-nuovo-computer-chat-impostazioni-e-server-mcp/#respond</comments>
		
		<dc:creator><![CDATA[Raffaele Chiatto]]></dc:creator>
		<pubDate>Wed, 04 Nov 2026 07:39:39 +0000</pubDate>
				<category><![CDATA[Anthropic Claude]]></category>
		<category><![CDATA[AI]]></category>
		<category><![CDATA[chat]]></category>
		<category><![CDATA[Claude]]></category>
		<category><![CDATA[Claude Code]]></category>
		<category><![CDATA[powershell]]></category>
		<guid isPermaLink="false">https://www.raffaelechiatto.com/?p=1125208</guid>

					<description><![CDATA[&#160; Quando si cambia computer, la prima cosa che si nota con Claude Code è che le conversazioni precedenti non ci sono più. Non è un bug: le chat di Claude Code non sono salvate nel cloud, ma in file locali dentro il profilo utente. La buona notizia è che per spostarle basta copiare una [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img loading="lazy" decoding="async" class="size-full wp-image-1091056 alignnone" src="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/INTERMEDIATE-BAR.png" alt="Migrare Claude Code su un nuovo computer chat, impostazioni e server MCP - Raffaele Chiatto" width="679" height="89" title="Migrare Claude Code su un nuovo computer chat, impostazioni e server MCP 26" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/INTERMEDIATE-BAR.png 679w, https://www.raffaelechiatto.com/wp-content/uploads/2020/12/INTERMEDIATE-BAR-480x63.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 679px, 100vw" /></p>
<p>&nbsp;</p>
<p>Quando si cambia computer, la prima cosa che si nota con Claude Code è che le conversazioni precedenti non ci sono più.</p>
<p>Non è un bug: le chat di Claude Code non sono salvate nel cloud, ma in file locali dentro il profilo utente.</p>
<p>La buona notizia è che per spostarle basta copiare una cartella.</p>
<p>Quella meno buona è che c&#8217;è un dettaglio sui percorsi che, se ignorato, rende le chat invisibili sul nuovo PC.</p>
<p>In questa guida vediamo dove si trovano i file, cosa copiare, come gestire il cambio di percorso e, alla fine, uno script PowerShell che fa tutto in automatico.</p>
<p>&nbsp;</p>
<h3><strong>DOVE SI TROVANO I FILE DI CLAUDE</strong></h3>
<p>Claude Code salva tutto in una cartella nascosta nel profilo utente:</p>
<p><strong>Windows: %USERPROFILE%\.claude\</strong></p>
<p><strong>macOS/Linux: ~/.claude/</strong></p>
<p>Al suo interno c&#8217;è la cartella projects\, che contiene una sottocartella per ogni progetto.</p>
<p>Ogni chat è un file .jsonl dentro la sottocartella del progetto a cui appartiene.</p>
<p>Il nome della sottocartella non è casuale: è il percorso assoluto del progetto, con i separatori (e in generale tutti i caratteri non alfanumerici) sostituiti da trattini.</p>
<p>Ad esempio:</p>
<p><strong>C:\Users\raf\Progetti\piva-manager</strong></p>
<p>diventa:</p>
<p><strong>C&#8211;Users-raf-Progetti-piva-manager</strong></p>
<p>&nbsp;</p>
<h3><strong>COSA COPIARE SUL NUOVO PC</strong></h3>
<p>Per una migrazione completa servono due elementi.</p>
<p>1. La cartella .claude\, che contiene:</p>
<p><strong>projects\</strong>: le chat<br />
<strong>settings.json</strong>: permessi e impostazioni<br />
<strong>CLAUDE.md</strong>: le istruzioni globali<br />
<strong>commands\, agents\ e skills\</strong>: se ne hai creati</p>
<p>2. Il file .claude.json, che si trova nella cartella utente accanto a .claude\, non dentro. Contiene la configurazione dei server MCP e le impostazioni dei singoli progetti. È facile dimenticarlo.</p>
<p><strong>ATTENZIONE:</strong> non copiare le credenziali. Sul nuovo PC avvia claude e rifai l&#8217;accesso con /login.</p>
<p>&nbsp;</p>
<h3><strong>IL PUNTO CRITICO: I PERCORSI</strong></h3>
<p>Claude Code associa le chat a un progetto tramite il suo percorso assoluto. Quando lanci claude &#8211;resume dentro una cartella, Claude Code calcola il nome codificato di quella cartella e cerca le chat nella sottocartella corrispondente di projects\.</p>
<p>Ci sono quindi due scenari.</p>
<h4></h4>
<h4><strong>Il percorso resta uguale</strong></h4>
<p>Stesso nome utente, stessa struttura di cartelle: copi .claude\ e .claude.json e funziona tutto senza fare altro.</p>
<h4></h4>
<h4><strong>Il percorso cambia</strong></h4>
<p>È il caso tipico quando sul nuovo PC il nome utente è diverso, ad esempio da C:\Users\raf\&#8230; a C:\Users\rchiatto\&#8230;, oppure quando sposti i progetti su un altro disco.</p>
<p>In questo caso devi rinominare ogni sottocartella dentro projects\ in base al nuovo percorso:</p>
<p><strong>C&#8211;Users-raf-Progetti-app-manager -&gt; C&#8211;Users-rchiatto-Progetti-app-manager</strong></p>
<p>Se non lo fai, claude &#8211;resume non trova le chat di quel progetto, anche se i file sono lì.</p>
<p>Inoltre i percorsi assoluti compaiono anche dentro i file: nelle chat .jsonl, in .claude.json (dove le impostazioni sono indicizzate per percorso di progetto) e a volte nei permessi di settings.json. Per una migrazione pulita conviene aggiornarli tutti.</p>
<p><strong>CONSIGLIO</strong>: il modo più semplice per evitare problemi è usare sul nuovo PC lo stesso nome utente e la stessa struttura di cartelle per i progetti.</p>
<h4></h4>
<h4><strong>Prima di copiare: la pulizia automatica delle sessioni</strong></h4>
<p>Di default Claude Code cancella le sessioni più vecchie di 30 giorni. Se vuoi conservarle più a lungo, aggiungi questa riga in settings.json:</p><pre class="urvanov-syntax-highlighter-plain-tag">json
{ "cleanupPeriodDays": 365 }</pre><p>Conviene farlo subito sul vecchio PC, prima della migrazione, così nel frattempo non perdi altre chat.</p>
<p>&nbsp;</p>
<h4><strong>Riaprire le chat sul nuovo PC</strong></h4>
<p>Dopo aver copiato i file, entra nella cartella del progetto e lancia:</p>
<p><strong>claude &#8211;resume</strong>: per scegliere una chat dall&#8217;elenco<br />
<strong>claude &#8211;continue</strong>: per riprendere l&#8217;ultima chat</p>
<p>&nbsp;</p>
<h3><strong>SCRIPT POWERSHELL</strong></h3>
<p>Fare tutto a mano va bene con due o tre progetti.</p>
<p>Con molti progetti, o con un cambio di nome utente, rinominare le cartelle e correggere i percorsi nei file diventa lungo e facile da sbagliare.</p>
<p>Per questo ho preparato uno script PowerShell che lavora in due fasi.</p>
<h4><strong>Cosa fa in modalità Esporta (vecchio PC)</strong></h4>
<ul>
<li>Imposta cleanupPeriodDays a 365 in settings.json (configurabile).</li>
<li>Copia .claude\ escludendo il file delle credenziali e copia .claude.json.</li>
<li>Salva in un manifest.json il percorso del profilo utente di origine.</li>
<li>Crea un archivio .zip pronto da trasferire.</li>
</ul>
<h4></h4>
<h4><strong>Cosa fa in modalità Importa (nuovo PC)</strong></h4>
<ul>
<li>Estrae l&#8217;archivio in una cartella temporanea.</li>
<li>Rinomina le sottocartelle di projects\ dal vecchio al nuovo percorso.</li>
<li>Aggiorna i percorsi dentro le chat .jsonl, .claude.json e settings.json.</li>
<li>Fa un backup della configurazione già presente (.claude.backup-&lt;data&gt; e .claude.json.backup-&lt;data&gt;).</li>
<li>Unisce i file nel profilo utente: se hai già fatto il login sul nuovo PC, resta valido.</li>
<li>Imposta cleanupPeriodDays anche sul nuovo PC.</li>
</ul>
<p>&nbsp;</p>
<h4><strong>Come si usa</strong></h4>
<p>Sul vecchio PC:</p>
<p>Da una powershell con diritti amministrativi eseguire il comando:</p><pre class="urvanov-syntax-highlighter-plain-tag">.\Migra-ClaudeCode.ps1 -Modalita Esporta -Archivio D:\claude-backup.zip</pre><p>Copia lo zip sul nuovo PC e lancia:</p><pre class="urvanov-syntax-highlighter-plain-tag">.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip</pre><p>Il cambio di profilo utente (ad esempio da C:\Users\raf a C:\Users\rchiatto) viene rilevato in automatico.</p>
<p>Se alcuni progetti stavano fuori dal profilo, o li hai spostati, aggiungi una mappatura vecchio → nuovo percorso con il comando:</p><pre class="urvanov-syntax-highlighter-plain-tag">.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip -MappaPercorsi @{ 'D:\Progetti' = 'C:\Dev' }</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h4><strong>Parametri Disponibili</strong></h4>
<ul>
<li><strong>Modalita</strong>: Esporta oppure Importa</li>
<li><strong>Archivio</strong>: Percorso dello zip da creare o da leggere</li>
<li><strong>MappaPercorsi</strong>: Mappature aggiuntive vecchio → nuovo percorso (solo Importa)</li>
<li><strong>VecchioProfilo</strong>: Forza il profilo di origine invece di leggerlo dal manifest (solo Importa)</li>
<li><strong>NonAggiornareContenuti</strong>: Rinomina solo le cartelle, senza modificare i percorsi nei file (solo Importa)</li>
<li><strong>GiorniConservazione</strong>: Valore di cleanupPeriodDays (default 365, 0 per non modificarlo)</li>
</ul>
<p>&nbsp;</p>
<h4><strong>Note Pratiche</strong></h4>
<p>Chiudi tutte le sessioni di Claude Code prima di lanciare lo script. Se ne trova una aperta, ti chiede conferma.</p>
<p>Se Windows blocca l&#8217;esecuzione degli script, avvialo così:</p><pre class="urvanov-syntax-highlighter-plain-tag">powershell -ExecutionPolicy Bypass -File .\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip</pre><p>Al termine, avvia claude e fai /login, poi entra nella cartella del progetto e lancia claude &#8211;resume.</p>
<p>Lo script è compatibile con Windows PowerShell 5.1 e con PowerShell 7.</p>
<p>&nbsp;</p>
<h3><strong>CONCLUSIONI</strong></h3>
<p>Spostare le chat di Claude Code su un nuovo PC è semplice se si ricordano tre cose: copiare sia .claude\ sia .claude.json, rifare il login invece di copiare le credenziali e, se il percorso dei progetti cambia, rinominare le cartelle in projects\.</p>
<p>Lo script qui sotto si occupa di tutti e tre i punti e fa un backup prima di toccare qualsiasi cosa.</p>
<p>&nbsp;</p>
<h3><strong>SCRIPT</strong></h3>
<p>Salva il codice seguente come<strong> Migra-ClaudeCode.ps1.</strong></p><pre class="urvanov-syntax-highlighter-plain-tag">&lt;#
.SYNOPSIS
Migra chat, impostazioni e configurazione di Claude Code da un PC Windows a un altro.

.DESCRIPTION
Modalita Esporta (vecchio PC):
- copia %USERPROFILE%\.claude\ (escluse le credenziali) e %USERPROFILE%\.claude.json
- salva il percorso del profilo di origine in un manifest
- crea un archivio .zip

Modalita Importa (nuovo PC):
- estrae l'archivio in una cartella temporanea
- rinomina le sottocartelle di projects\ in base al nuovo percorso
- aggiorna i percorsi dentro i file .jsonl, .claude.json e settings.json
- fa un backup di quanto gia presente e poi unisce i file in %USERPROFILE%
- imposta cleanupPeriodDays in settings.json

.PARAMETER Modalita
Esporta oppure Importa.

.PARAMETER Archivio
Percorso del file .zip da creare (Esporta) o da leggere (Importa).

.PARAMETER MappaPercorsi
Solo Importa. Mappature aggiuntive vecchio -&gt; nuovo percorso, per progetti che stavano
fuori dal profilo utente o che hai spostato. Es: @{ 'D:\Progetti' = 'C:\Dev' }
Il cambio del profilo utente (C:\Users\vecchio -&gt; C:\Users\nuovo) e' gia gestito in automatico.

.PARAMETER VecchioProfilo
Solo Importa. Forza il percorso del profilo di origine (di default lo legge dal manifest).

.PARAMETER NonAggiornareContenuti
Solo Importa. Rinomina solo le cartelle, senza modificare i percorsi dentro i file.

.PARAMETER GiorniConservazione
Valore di cleanupPeriodDays da scrivere in settings.json (0 = non toccare). Default 365.
In Esporta viene applicato anche sul vecchio PC, cosi le chat non vengono cancellate nel frattempo.

.EXAMPLE
# Sul vecchio PC
.\Migra-ClaudeCode.ps1 -Modalita Esporta -Archivio D:\claude-backup.zip

.EXAMPLE
# Sul nuovo PC
.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip

.EXAMPLE
# Sul nuovo PC, con progetti spostati da D:\Progetti a C:\Dev
.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip -MappaPercorsi @{ 'D:\Progetti' = 'C:\Dev' }
#&gt;
[CmdletBinding()]
param(
[Parameter(Mandatory)][ValidateSet('Esporta', 'Importa')][string]$Modalita,
[Parameter(Mandatory)][string]$Archivio,
[hashtable]$MappaPercorsi = @{},
[string]$VecchioProfilo,
[switch]$NonAggiornareContenuti,
[int]$GiorniConservazione = 365
)

$ErrorActionPreference = 'Stop'
Add-Type -AssemblyName System.IO.Compression.FileSystem
$Utf8NoBom = New-Object System.Text.UTF8Encoding($false)

$Profilo = $env:USERPROFILE
$DirClaude = Join-Path $Profilo '.claude'
$FileClaudeJs = Join-Path $Profilo '.claude.json'
$Archivio = [IO.Path]::GetFullPath($Archivio)

# --- Funzioni ---------------------------------------------------------------

function Get-NomeCartellaProgetto([string]$Percorso) {
# Claude Code sostituisce ogni carattere non alfanumerico con '-'
return ($Percorso.TrimEnd('\', '/') -replace '[^a-zA-Z0-9]', '-')
}

function Invoke-Robocopy([string]$Da, [string]$A, [string[]]$Extra = @()) {
$arg = @($Da, $A, '/E', '/R:1', '/W:1', '/NFL', '/NDL', '/NJH', '/NJS', '/NP') + $Extra
&amp; robocopy @arg | Out-Null
if ($LASTEXITCODE -ge 8) { throw "robocopy fallito ($LASTEXITCODE): $Da -&gt; $A" }
}

function Set-Conservazione([string]$Cartella, [int]$Giorni) {
if ($Giorni -le 0) { return }
if (-not (Test-Path $Cartella)) { New-Item -ItemType Directory -Path $Cartella | Out-Null }
$file = Join-Path $Cartella 'settings.json'
if (Test-Path $file) {
$cfg = Get-Content $file -Raw -Encoding UTF8 | ConvertFrom-Json
if ($null -eq $cfg) { $cfg = New-Object PSObject }
} else {
$cfg = New-Object PSObject
}
$attuale = $cfg.cleanupPeriodDays
if ($null -eq $attuale -or [int]$attuale -lt $Giorni) {
$cfg | Add-Member -NotePropertyName cleanupPeriodDays -NotePropertyValue $Giorni -Force
[IO.File]::WriteAllText($file, ($cfg | ConvertTo-Json -Depth 50), $Utf8NoBom)
Write-Host " cleanupPeriodDays impostato a $Giorni in $file"
} else {
Write-Host " cleanupPeriodDays gia a $attuale, non modificato"
}
}

function Update-PercorsiNelTesto([string]$File, $Mappe) {
$testo = [IO.File]::ReadAllText($File, [Text.Encoding]::UTF8)
$orig = $testo
foreach ($m in $Mappe) {
# Forma JSON con backslash raddoppiati (C:\\Users\\raf) e forma con slash (C:/Users/raf)
$forme = @(
@{ Da = $m.Vecchio.Replace('\', '\\'); A = $m.Nuovo.Replace('\', '\\') },
@{ Da = $m.Vecchio.Replace('\', '/'); A = $m.Nuovo.Replace('\', '/') }
)
foreach ($f in $forme) {
$pattern = [regex]::Escape($f.Da) + '(?![A-Za-z0-9_.\-])'
$testo = [regex]::Replace($testo, $pattern, $f.A.Replace('$', '$$'), 'IgnoreCase')
}
}
if ($testo -cne $orig) {
[IO.File]::WriteAllText($File, $testo, $Utf8NoBom)
return $true
}
return $false
}

# --- Controllo preliminare --------------------------------------------------

if (Get-Process -Name 'claude' -ErrorAction SilentlyContinue) {
Write-Warning 'Claude Code risulta in esecuzione. Chiudi tutte le sessioni prima di continuare.'
if ((Read-Host 'Continuare comunque? (s/N)') -ne 's') { return }
}

$Temp = Join-Path $env:TEMP ('claude-migrazione-' + [guid]::NewGuid().ToString('N').Substring(0, 8))
New-Item -ItemType Directory -Path $Temp | Out-Null

try {
# =======================================================================
if ($Modalita -eq 'Esporta') {
# =======================================================================
if (-not (Test-Path $DirClaude)) { throw "Cartella non trovata: $DirClaude" }

Write-Host '1/4 Impostazione conservazione chat sul PC attuale...'
Set-Conservazione -Cartella $DirClaude -Giorni $GiorniConservazione

Write-Host '2/4 Copia di .claude (senza credenziali)...'
Invoke-Robocopy $DirClaude (Join-Path $Temp '.claude') @('/XF', '.credentials.json')
if (Test-Path $FileClaudeJs) { Copy-Item $FileClaudeJs (Join-Path $Temp '.claude.json') }
else { Write-Warning ".claude.json non trovato in $Profilo" }

Write-Host '3/4 Scrittura manifest...'
@{
ProfiloOrigine = $Profilo
Computer = $env:COMPUTERNAME
Utente = $env:USERNAME
Data = (Get-Date).ToString('s')
} | ConvertTo-Json | Set-Content (Join-Path $Temp 'manifest.json') -Encoding UTF8

Write-Host '4/4 Creazione archivio...'
if (Test-Path $Archivio) { Remove-Item $Archivio -Force }
$dirArchivio = Split-Path $Archivio -Parent
if (-not (Test-Path $dirArchivio)) { New-Item -ItemType Directory -Path $dirArchivio | Out-Null }
[IO.Compression.ZipFile]::CreateFromDirectory($Temp, $Archivio)

$nChat = @(Get-ChildItem (Join-Path $Temp '.claude\projects') -Recurse -Filter *.jsonl -ErrorAction SilentlyContinue).Count
$mb = [math]::Round((Get-Item $Archivio).Length / 1MB, 1)
Write-Host ''
Write-Host "Fatto. Archivio: $Archivio ($mb MB, $nChat chat)." -ForegroundColor Green
Write-Host 'Copialo sul nuovo PC e lancia lo script in modalita Importa.'
}
# =======================================================================
else {
# =======================================================================
if (-not (Test-Path $Archivio)) { throw "Archivio non trovato: $Archivio" }

Write-Host '1/6 Estrazione archivio...'
[IO.Compression.ZipFile]::ExtractToDirectory($Archivio, $Temp)
$TmpClaude = Join-Path $Temp '.claude'
$TmpClaudeJs = Join-Path $Temp '.claude.json'
$TmpProjects = Join-Path $TmpClaude 'projects'

if (-not $VecchioProfilo) {
$man = Join-Path $Temp 'manifest.json'
if (-not (Test-Path $man)) { throw 'manifest.json mancante: specifica -VecchioProfilo' }
$VecchioProfilo = (Get-Content $man -Raw | ConvertFrom-Json).ProfiloOrigine
}
Write-Host " Profilo origine: $VecchioProfilo"
Write-Host " Profilo destinazione: $Profilo"

# Mappature, dalla piu specifica alla piu generica
$Mappe = @()
foreach ($k in $MappaPercorsi.Keys) {
$Mappe += [pscustomobject]@{ Vecchio = $k.TrimEnd('\'); Nuovo = ([string]$MappaPercorsi[$k]).TrimEnd('\') }
}
if ($VecchioProfilo.TrimEnd('\') -ne $Profilo.TrimEnd('\')) {
$Mappe += [pscustomobject]@{ Vecchio = $VecchioProfilo.TrimEnd('\'); Nuovo = $Profilo.TrimEnd('\') }
}
$Mappe = @($Mappe | Sort-Object { $_.Vecchio.Length } -Descending)
foreach ($m in $Mappe) { Write-Host " Mappa: $($m.Vecchio) -&gt; $($m.Nuovo)" }

Write-Host '2/6 Rinomina cartelle dei progetti...'
$rinominate = 0
if ($Mappe.Count -gt 0 -and (Test-Path $TmpProjects)) {
foreach ($dir in Get-ChildItem $TmpProjects -Directory) {
$nome = $dir.Name
$nuovoNome = $null
foreach ($m in $Mappe) {
$prefOld = Get-NomeCartellaProgetto $m.Vecchio
if ($nome.StartsWith($prefOld, [StringComparison]::OrdinalIgnoreCase) -and
($nome.Length -eq $prefOld.Length -or $nome[$prefOld.Length] -eq '-')) {
$nuovoNome = (Get-NomeCartellaProgetto $m.Nuovo) + $nome.Substring($prefOld.Length)
break
}
}
if (-not $nuovoNome -or $nuovoNome -ceq $nome) { continue }

$dest = Join-Path $TmpProjects $nuovoNome
if ($nuovoNome -eq $nome) {
# Cambia solo maiuscole/minuscole: passaggio tramite nome temporaneo
$tmpName = $nome + '__tmp'
Rename-Item $dir.FullName $tmpName
Rename-Item (Join-Path $TmpProjects $tmpName) $nuovoNome
} elseif (Test-Path $dest) {
Invoke-Robocopy $dir.FullName $dest @('/MOVE')
if (Test-Path $dir.FullName) { Remove-Item $dir.FullName -Recurse -Force }
} else {
Rename-Item $dir.FullName $nuovoNome
}
Write-Host " $nome -&gt; $nuovoNome"
$rinominate++
}
}
Write-Host " Cartelle rinominate: $rinominate"

Write-Host '3/6 Aggiornamento percorsi nei file...'
$aggiornati = 0
if ($Mappe.Count -gt 0 -and -not $NonAggiornareContenuti) {
$file = @()
if (Test-Path $TmpProjects) { $file += Get-ChildItem $TmpProjects -Recurse -File -Filter *.jsonl }
if (Test-Path $TmpClaudeJs) { $file += Get-Item $TmpClaudeJs }
$settings = Join-Path $TmpClaude 'settings.json'
if (Test-Path $settings) { $file += Get-Item $settings }
$i = 0
foreach ($f in $file) {
$i++
Write-Progress -Activity 'Aggiornamento percorsi' -Status $f.Name -PercentComplete (100 * $i / $file.Count)
if (Update-PercorsiNelTesto $f.FullName $Mappe) { $aggiornati++ }
}
Write-Progress -Activity 'Aggiornamento percorsi' -Completed
}
Write-Host " File modificati: $aggiornati"

Write-Host '4/6 Backup della configurazione esistente...'
$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
if (Test-Path $DirClaude) {
$bk = "$DirClaude.backup-$stamp"
Invoke-Robocopy $DirClaude $bk
Write-Host " $bk"
}
if (Test-Path $FileClaudeJs) {
Copy-Item $FileClaudeJs "$FileClaudeJs.backup-$stamp"
Write-Host " $FileClaudeJs.backup-$stamp"
}

Write-Host '5/6 Copia nel profilo utente...'
Invoke-Robocopy $TmpClaude $DirClaude # unione: le credenziali gia presenti restano
if (Test-Path $TmpClaudeJs) { Copy-Item $TmpClaudeJs $FileClaudeJs -Force }

Write-Host '6/6 Impostazione conservazione chat...'
Set-Conservazione -Cartella $DirClaude -Giorni $GiorniConservazione

Write-Host ''
Write-Host 'Importazione completata.' -ForegroundColor Green
Write-Host 'Prossimi passi:'
Write-Host ' 1. claude e poi /login (le credenziali non vengono migrate)'
Write-Host ' 2. cd nella cartella del progetto, poi claude --resume'
Write-Host ''
Write-Host 'Cartelle progetto presenti ora:'
Get-ChildItem (Join-Path $DirClaude 'projects') -Directory -ErrorAction SilentlyContinue |
ForEach-Object { Write-Host " $($_.Name)" }
}
}
finally {
Remove-Item $Temp -Recurse -Force -ErrorAction SilentlyContinue
}</pre><p>&nbsp;</p>

<div class="wp-block-button">
<a  data-e-Disable-Page-Transition="true" class="dlm-download-link dlm-download-button wp-block-button__link wp-element-button" title="Versione v1.0" href="https://www.raffaelechiatto.com/download/1125218/?tmstv=1794997734" rel="nofollow" id="download-link-1125218" data-redirect="false" >
	Download &ldquo;Migra-ClaudeCode.zip&rdquo;	<span class="dlm-button-meta">Migra-ClaudeCode.zip		&ndash; <span
			class="dlm-download-count-value"
			data-count-format="times">Downloaded 559 times</span>
		&ndash; 5,46 KB</span>
</a>
</div>

]]></content:encoded>
					
					<wfw:commentRss>https://www.raffaelechiatto.com/migrare-claude-code-su-un-nuovo-computer-chat-impostazioni-e-server-mcp/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			<enclosure length="5590" type="application/zip" url="https://www.raffaelechiatto.com/download/1125218/?tmstv=1793783002"/><itunes:explicit>no</itunes:explicit><itunes:subtitle>&amp;#160; Quando si cambia computer, la prima cosa che si nota con Claude Code è che le conversazioni precedenti non ci sono più. Non è un bug: le chat di Claude Code non sono salvate nel cloud, ma in file locali dentro il profilo utente. La buona notizia è che per spostarle basta copiare una [&amp;#8230;]</itunes:subtitle><itunes:summary>&amp;#160; Quando si cambia computer, la prima cosa che si nota con Claude Code è che le conversazioni precedenti non ci sono più. Non è un bug: le chat di Claude Code non sono salvate nel cloud, ma in file locali dentro il profilo utente. La buona notizia è che per spostarle basta copiare una [&amp;#8230;]</itunes:summary><itunes:keywords>Anthropic Claude, AI, chat, Claude, Claude Code, powershell</itunes:keywords></item>
		<item>
		<title>Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04</title>
		<link>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-roundcube-su-ubuntu-server-26-04/</link>
					<comments>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-roundcube-su-ubuntu-server-26-04/#respond</comments>
		
		<dc:creator><![CDATA[Raffaele Chiatto]]></dc:creator>
		<pubDate>Mon, 02 Nov 2026 07:35:45 +0000</pubDate>
				<category><![CDATA[Roundcube]]></category>
		<category><![CDATA[Ubuntu]]></category>
		<category><![CDATA[apache]]></category>
		<category><![CDATA[MariaDB]]></category>
		<category><![CDATA[php]]></category>
		<category><![CDATA[roundcube]]></category>
		<guid isPermaLink="false">https://www.raffaelechiatto.com/?p=1125175</guid>

					<description><![CDATA[&#160; Roundcube è uno dei client webmail open source più diffusi e apprezzati: un’interfaccia web moderna, leggera e completamente responsive che permette di consultare la propria posta da qualsiasi browser, senza installare nulla sul dispositivo. Scritto in PHP e distribuito con licenza GPL, viene adottato da provider di hosting, università e aziende di ogni dimensione [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img loading="lazy" decoding="async" class="size-full wp-image-1091058 alignnone" src="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png" alt="Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04 - Raffaele Chiatto" width="679" height="89" title="Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04 30" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR.png 679w, https://www.raffaelechiatto.com/wp-content/uploads/2020/12/ADVANCED-BAR-480x63.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 679px, 100vw" /></p>
<p>&nbsp;</p>
<p>Roundcube è uno dei client webmail open source più diffusi e apprezzati: un’interfaccia web moderna, leggera e completamente responsive che permette di consultare la propria posta da qualsiasi browser, senza installare nulla sul dispositivo.</p>
<p>Scritto in PHP e distribuito con licenza GPL, viene adottato da provider di hosting, università e aziende di ogni dimensione proprio per la sua semplicità e affidabilità.</p>
<p>Con il tema Elastic, predefinito dalle versioni più recenti, Roundcube offre un’esperienza d’uso molto vicina a quella dei client desktop: gestione di cartelle e filtri, rubrica integrata, ricerca rapida, supporto agli allegati con drag &amp; drop e un sistema di plugin che consente di estenderne le funzionalità, dai filtri lato server con Sieve all’archiviazione dei messaggi.</p>
<p>È importante chiarire subito un punto: Roundcube non è un server di posta.</p>
<p>Si tratta esclusivamente di un’interfaccia web che si collega a un server IMAP/SMTP già esistente, sia esso un server aziendale basato su Postfix e Dovecot, un provider esterno o un servizio come Google Workspace.</p>
<p>Questo lo rende ideale per chi desidera offrire ai propri utenti una webmail self-hosted, mantenendo il pieno controllo sui dati e sull’infrastruttura.</p>
<p>In questa guida vedremo passo dopo passo come installare e configurare Roundcube 1.7 su Ubuntu Server 26.04 LTS, utilizzando lo stack classico Apache, PHP 8.5 e MariaDB.</p>
<p>Partiremo da un server appena installato e arriveremo a una webmail funzionante, pronta per il primo accesso.</p>
<p>&nbsp;</p>
<h3><strong>PREREQUISITI</strong></h3>
<ul>
<li>Server con Ubuntu Server 26.04 LTS appena installato, accesso sudo o root via SSH.</li>
<li>Risorse minime: 1 vCPU, 1–2 GB di RAM, 5 GB di spazio disco (Roundcube è molto più leggero di un CRM completo).</li>
<li>Un dominio che punti all&#8217;IP del server (facoltativo ma consigliato per HTTPS).</li>
<li>Firewall con le porte 22 (SSH), 80 (HTTP) e 443 (HTTPS) raggiungibili.</li>
</ul>
<p><strong>IMPORTANTE</strong>: Roundcube è un client webmail, non un server di posta. Serve già un server IMAP/SMTP funzionante a cui collegarsi (il tuo provider, un server Postfix/Dovecot aziendale, Google Workspace, ecc.). Questa guida configura solo l&#8217;interfaccia web.</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>AGGIORNAMENTO DEL SISTEMA</strong></h3>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt update &amp;&amp; sudo apt upgrade -y

sudo apt install -y software-properties-common curl wget tar ufw

sudo ufw allow OpenSSH

sudo ufw enable</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI APACHE</strong></h3>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y apache2

sudo systemctl enable --now apache2

sudo ufw allow "Apache Full"</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE DI PHP E DELLE ESTENSIONI</strong></h3>
<p>Roundcube 1.7 richiede PHP 8.1 o superiore: il PHP 8.5 già presente nei repository di Ubuntu 26.04 va benissimo, nessuna PPA necessaria.</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y php libapache2-mod-php php-cli \
php-mysql php-mbstring php-intl php-xml php-curl \
php-zip php-gd php-imagick php-ldap</pre><p>Le estensioni PCRE, DOM, JSON, Session, OpenSSL, Filter, Ctype e Sodium sono già incluse nel core di PHP 8.5, quindi non servono pacchetti a parte.</p>
<p>Parametri consigliati. Apri <strong>/etc/php/8.5/apache2/php.ini</strong> e alza i limiti per gestire comodamente gli allegati email:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo sed -i \
-e 's/^memory_limit = .*/memory_limit = 256M/' \
-e 's/^upload_max_filesize = .*/upload_max_filesize = 25M/' \
-e 's/^post_max_size = .*/post_max_size = 30M/' \
-e 's/^max_execution_time = .*/max_execution_time = 120/' \
-e 's/^;date.timezone =.*/date.timezone = Europe\/Rome/' \
/etc/php/8.5/apache2/php.ini</pre><p>Quindi riavviare Apache:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo systemctl restart apache2</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>INSTALLAZIONE E CONFIGURAZIONE DI MARIADB</strong></h3>
<p>Installare MariDB con i seguenti comandi:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y mariadb-server

sudo systemctl enable --now mariadb

sudo mariadb-secure-installation</pre><p>Durante mysql_secure_installation rispondi<strong> Y</strong> a tutte le domande.</p>
<p>Poi crea il database con i seguenti comandi:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo mysql -u root -p</pre><p>Quindi eseguire i comandi:</p><pre class="urvanov-syntax-highlighter-plain-tag">CREATE DATABASE roundcubemail CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'roundcube_user'@'localhost' IDENTIFIED BY 'Password_Sicura!23';
GRANT ALL PRIVILEGES ON roundcubemail.* TO 'roundcube_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;</pre><p><strong>NOTA BENE</strong>: sostituisci Password_Sicura!23 con una password robusta servirà nel file di configurazione allo step <strong>IMPORTAZIONE DELLO SCHEMA DEL DATABASE</strong>.</p>
<p>&nbsp;</p>
<h3><strong>DOWNLOAD ED ESTRAZIONE DI ROUNDCUBE</strong></h3>
<p>Scarica il pacchetto &#8220;complete&#8221; (include già le dipendenze, non serve Composer).</p>
<p>La versione 1.7.1 è la release stabile attuale al momento della stesura controlla su <strong>roundcube.net/download</strong> se ne è uscita una più recente.</p><pre class="urvanov-syntax-highlighter-plain-tag">cd /tmp

wget https://github.com/roundcube/roundcubemail/releases/download/1.7.1/roundcubemail-1.7.1-complete.tar.gz

sudo mkdir -p /var/www/roundcube

sudo tar xzf roundcubemail-1.7.1-complete.tar.gz -C /var/www/roundcube --strip-components=1</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>IMPORTAZIONE DELLO SCHEMA DEL DATABASE</strong></h3>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">mysql -u roundcube_user -p roundcubemail &lt; /var/www/roundcube/SQL/mysql.initial.sql</pre><p>&nbsp;</p>
<h3><strong>FILE DI CONFIGURAZIONE (CONFIG.INC.PHP)</strong></h3>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo cp /var/www/roundcube/config/config.inc.php.sample /var/www/roundcube/config/config.inc.php

openssl rand -base64 24

sudo nano /var/www/roundcube/config/config.inc.php</pre><p>Il comando openssl rand -base64 24 genera una chiave casuale: copiala nel campo des_key. Imposta questi valori nel file:</p><pre class="urvanov-syntax-highlighter-plain-tag">$config['db_dsnw'] = 'mysql://roundcube_user:Password_Sicura!23@localhost/roundcubemail';

$config['imap_host'] = 'ssl://mail.tuodominio.org:993';
$config['smtp_host'] = 'tls://mail.tuodominio.org:587';
$config['smtp_user'] = '%u';
$config['smtp_pass'] = '%p';

$config['des_key'] = 'INCOLLA_QUI_LA_CHIAVE_GENERATA';

$config['plugins'] = ['archive', 'zipdownload'];

$config['support_url'] = '';
$config['product_name'] = 'Webmail';</pre><p>Sostituisci <strong>mail.tuodominio.org</strong> con l&#8217;host IMAP/SMTP reale del tuo provider di posta.</p>
<p>Se il tuo server di posta supporta Sieve (filtri lato server via Dovecot), puoi aggiungere &#8216;managesieve&#8217; all&#8217;elenco dei plugin e impostare $config[&#8216;managesieve_host&#8217;].</p>
<p>&nbsp;</p>
<h3><strong>PERMESSI DEI FILES</strong></h3>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo chown -R www-data:www-data /var/www/roundcube
sudo find /var/www/roundcube -type d -exec chmod 755 {} \;
sudo find /var/www/roundcube -type f -exec chmod 644 {} \;
sudo chmod -R 770 /var/www/roundcube/temp /var/www/roundcube/logs</pre><p>Le cartelle temp e logs devono restare scrivibili da Apache; il resto dell&#8217;installazione no.</p>
<p>&nbsp;</p>
<h3><strong>VIRTUAL HOST DI APACHE</strong></h3>
<p>Dalla versione 1.5 in poi, Roundcube serve i file dalla sottocartella public_html/, non dalla radice del pacchetto è importante puntare lì il document root e bloccare l&#8217;accesso diretto alle altre cartelle.</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo a2enmod rewrite
sudo nano /etc/apache2/sites-available/roundcube.conf</pre><p>Contenuto del file <strong>/etc/apache2/sites-available/roundcube.conf</strong>:</p><pre class="urvanov-syntax-highlighter-plain-tag">&lt;VirtualHost *:80&gt;
ServerName webmail.tuodominio.org
DocumentRoot /var/www/roundcube/public_html

&lt;Directory /var/www/roundcube/public_html&gt;
AllowOverride All
Require all granted
&lt;/Directory&gt;

&lt;DirectoryMatch "/var/www/roundcube/(config|temp|logs|SQL|bin|installer)"&gt;
Require all denied
&lt;/DirectoryMatch&gt;

ErrorLog ${APACHE_LOG_DIR}/roundcube_error.log
CustomLog ${APACHE_LOG_DIR}/roundcube_access.log combined
&lt;/VirtualHost&gt;</pre><p>Attiva il sito con i comandi:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo a2ensite roundcube.conf

sudo a2dissite 000-default.conf

sudo systemctl reload apache2</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>PRIMO ACCESSO E VERIFICA</strong></h3>
<p>Apri <strong>http://webmail.tuodominio.org</strong> nel browser: dovresti vedere la schermata di login di Roundcube.</p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-01.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125180 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-01-1024x509.png" alt="Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="509" title="Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04 31" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-01-980x487.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-01-480x238.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Accedi con un account email reale (utente e password IMAP del tuo server di posta) e verifica che la casella si carichi correttamente.</p>
<p><a href="https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-02.png"><img loading="lazy" decoding="async" class="aligncenter wp-image-1125181 size-large" src="https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-02-1024x640.png" alt="Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04 - Raffaele Chiatto" width="1024" height="640" title="Installazione e Configurazione Base di Roundcube su Ubuntu Server 26.04 32" srcset="https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-02-980x613.png 980w, https://www.raffaelechiatto.com/wp-content/uploads/2026/10/inst-rouncube-ubuntu-02-480x300.png 480w" sizes="(min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) and (max-width: 980px) 980px, (min-width: 981px) 1024px, 100vw" /></a></p>
<p>Sopra un immagine che mostra il <strong>client della Mailbox</strong></p>
<p>Se preferisci usare l&#8217;installer guidato via browser invece della modifica manuale di config.inc.php (step 07), puoi visitare http://webmail.tuodominio.org/installer/: ricordati però di eliminarlo subito dopo l&#8217;uso, perché espone dettagli di configurazione:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo rm -rf /var/www/roundcube/installer</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>HTTPS CON LET&#8217;S ENCRYPT</strong></h3>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo apt install -y certbot python3-certbot-apache
sudo certbot --apache -d webmail.tuodominio.org</pre><p>Verifica il rinnovo automatico:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo certbot renew --dry-run</pre><p>&nbsp;</p>
<p>&nbsp;</p>
<h3><strong>CONFIGURAZIONE DI BASE AGGIUNTIVA</strong></h3>
<p>Pulizia automatica del database: Roundcube include uno script per rimuovere sessioni scadute e voci temporanee.</p>
<p>Aggiungilo al cron:</p><pre class="urvanov-syntax-highlighter-plain-tag">sudo crontab -u www-data -e
0 3 * * * /var/www/roundcube/bin/cleandb.sh &gt; /dev/null 2&gt;&amp;1</pre><p><strong>Identità e firma predefinita</strong>: dopo il primo login, in <strong>Impostazioni → Identità</strong> puoi definire nome, firma e risposta automatica predefiniti per i nuovi utenti.</p>
<p><strong>Limiti di accesso</strong>: se il webmail è esposto pubblicamente, valuta di limitare i tentativi di login (fail2ban con il filtro per Roundcube è un&#8217;opzione comune) per ridurre il rischio di brute force.</p>
<p>Checklist di verifica finale</p>
<ul>
<li>Servizi attivi systemctl status apache2 mariadb restituiscono entrambi &#8220;active (running)&#8221;.</li>
<li>Login riuscito con un account IMAP reale e casella caricata correttamente.</li>
<li>Invio di un&#8217;email di test riuscito (verifica la connessione SMTP).</li>
<li>Cartella /installer rimossa o comunque non raggiungibile dall&#8217;esterno.</li>
<li>Sito raggiungibile in HTTPS senza avvisi del certificato.</li>
<li>Cron cleandb.sh configurato per la pulizia periodica del database.</li>
<li>Nessun errore di scrittura su temp/ e logs/ durante l&#8217;uso normale.</li>
</ul>
<p>&nbsp;</p>
<h3><strong>CONCLUSIONI</strong></h3>
<p>Con questa guida abbiamo visto come installare e configurare Roundcube 1.7 su Ubuntu Server 26.04 LTS, partendo da un server appena installato fino ad arrivare a una webmail funzionante.</p>
<p>Abbiamo preparato lo stack Apache, PHP 8.5 e MariaDB, creato il database dedicato, configurato il collegamento al server IMAP/SMTP e impostato un virtual host che espone solo la cartella public_html, come raccomandato dalle versioni più recenti.</p>
<p>Il risultato è una webmail self-hosted leggera, moderna e facilmente personalizzabile.</p>
<p>È adatta sia a piccole realtà che vogliono offrire un accesso web alla posta, sia a contesti aziendali che preferiscono mantenere il pieno controllo dei dati senza affidarsi a servizi esterni.</p>
<p>Prima di mettere Roundcube in produzione, consiglio alcuni passaggi aggiuntivi:</p>
<ul>
<li>Attivare HTTPS con un certificato Let’s Encrypt tramite Certbot, così che credenziali e messaggi non viaggino mai in chiaro.</li>
<li>Rimuovere la cartella installer e verificare che enable_installer sia disattivato.</li>
<li>Proteggere il login da attacchi brute force, ad esempio con Fail2ban configurato sui log di Roundcube.</li>
<li>Pianificare backup regolari del database roundcubemail e del file config.inc.php.</li>
<li>Tenere aggiornato Roundcube, seguendo le release ufficiali: gli aggiornamenti di sicurezza sono frequenti e importanti per un’applicazione esposta su Internet.</li>
</ul>
<p>Da qui in poi si può estendere la webmail con i numerosi plugin disponibili, come managesieve per i filtri lato server, password per permettere agli utenti di cambiare la propria password o l’autenticazione a due fattori, adattandola alle proprie esigenze.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://www.raffaelechiatto.com/installazione-e-configurazione-base-di-roundcube-su-ubuntu-server-26-04/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
	</channel>
</rss>