Come installare il Desktop Telematico su Windows 11

byDomenico De Rosa

Se hai appena formattato il PC, cambiato ufficio o preso in mano per la prima volta il software dell’Agenzia delle Entrate, la prima cosa che noti è che le guide in giro sono contraddittorie: alcune parlano di installer .exe, altre di JDK da configurare a mano, altre ancora di zip. Buona notizia: da fine 2025 la procedura è cambiata, ed è diventata più semplice di quanto raccontino molti articoli ancora online.

Per installare il Desktop Telematico su Windows 11 basta scaricare il pacchetto ZIP (32 o 64 bit) dal sito ufficiale dell’Agenzia delle Entrate, estrarlo in una cartella senza spazi nel percorso ed eseguire DesktopTelematico.exe: dalla versione 1.3.0 il programma include già la JRE 8 necessaria, quindi non serve più installare Java a parte. È il cambiamento più importante degli ultimi mesi, e risolve alla radice buona parte dei problemi che hanno reso famoso questo software tra i commercialisti.

Cos’è cambiato: addio all’installer, benvenuto lo ZIP

Fino a novembre 2025 il Desktop Telematico si scaricava come eseguibile (tipicamente DesktopTelematico_win32_120...exe) che, in fase di installazione, andava a cercare una Java Virtual Machine già presente sul sistema. Era proprio lì che nascevano il 90% dei problemi: se sul PC c’erano più versioni di Java installate, o se il percorso non corrispondeva a quello atteso dall’installer, compariva il famigerato errore “A Java Exception has occurred”, oppure Windows Error 2 o 3 durante il caricamento della VM.

Con l’aggiornamento annunciato a metà novembre 2025, l’Agenzia ha cambiato modello di distribuzione: il pacchetto per Windows (sia 32 che 64 bit), macOS e Linux è ora uno ZIP che include già la JRE 8 al proprio interno. Non c’è più una procedura guidata da seguire passo dopo passo: si estrae l’archivio e si lancia direttamente l’applicazione. Alla data in cui scrivo questo articolo la versione distribuita è la 1.4.0, di giugno 2026 (FONTE: Applicazione Desktop Telematico, telematici.agenziaentrate.gov.it).

Un dettaglio che vale la pena avere chiaro prima di partire: gran parte dei tutorial più cliccati che si trovano cercando “desktop telematico windows 11 errore java” descrivono ancora la vecchia procedura, con tanto di istruzioni per installare JDK 11, impostare JAVA_HOME e modificare il Path di sistema. Non è che sbagliano — erano corretti quando sono stati scritti — ma applicarli oggi, su un pacchetto che porta già il proprio Java integrato, rischia solo di creare un conflitto in più tra la JRE del sistema e quella del programma.

Come installare il Desktop Telematico su Windows 11, passo per passo

  1. Vai sulla pagina ufficiale. Il punto di riferimento è telematici.agenziaentrate.gov.it/Main/Desktop.jsp, raggiungibile anche dal portale principale in Servizi → Servizi trasversali → Desktop telematico. Il download del pacchetto non richiede l’accesso con SPID, CIE o CNS: le credenziali ti serviranno solo dopo, per configurare l’utenza Entratel o Fisconline dentro il programma.
  2. Scegli la versione giusta. Su Windows 11 quasi tutti i PC in circolazione oggi sono a 64 bit: scarica quella, a meno che tu non sappia con certezza di avere un sistema a 32 bit (capita ancora su qualche macchina datata negli studi più piccoli).
  3. Verifica l’integrità del file scaricato, se vuoi fare le cose per bene. La pagina ufficiale pubblica l’hash SHA-256 di ogni pacchetto: un confronto con il valore calcolato sul file scaricato (in PowerShell basta Get-FileHash nomefile.zip -Algorithm SHA256) ti conferma che il download non si è corrotto. Passaggio che quasi nessuno fa, ma che evita ore perse a inseguire un errore che in realtà dipende da uno ZIP incompleto.
  4. Estrai l’archivio in una cartella semplice, tipo C:\DesktopTelematico. Evita percorsi con spazi o caratteri accentati: non è più un requisito documentato ufficialmente come lo era in passato, ma in pratica capita ancora che percorsi complicati mandino in confusione moduli scritti in Java meno recente.
  5. Esegui DesktopTelematico.exe dalla cartella estratta, possibilmente con tasto destro → Esegui come amministratore la prima volta, così eviti richieste di permessi a metà avvio.
  6. Al primo avvio crea un nuovo utente locale del programma, con relativa cartella di lavoro (workspace) e password: sono credenziali interne all’applicazione, diverse da SPID e dal PIN Fisconline, e servono a proteggere l’ambiente di sicurezza (le chiavi) che il software genera per te.
  7. Lascia che il programma controlli gli aggiornamenti al primo avvio: serve connessione internet, e da qui in poi l’aggiornamento è automatico salvo blocchi del firewall aziendale.

Da qui in poi si tratta di importare l’ambiente di sicurezza se ne avevi già uno da un’installazione precedente, o di generarne uno nuovo se parti da zero — ma questa è più una questione di configurazione dell’utenza che di installazione del software, e meriterebbe un articolo a parte.

Se compare ancora un errore Java

Capita, soprattutto su macchine che in passato hanno già avuto un’installazione vecchia del Desktop Telematico o installazioni Java “storiche” lasciate a metà. Nella pratica gli scenari più frequenti sono due, ed è bene distinguerli perché la causa (e la soluzione) non è la stessa:

Hai scaricato per sbaglio un pacchetto vecchio, magari da un link salvato nei preferiti o da un sito terzo che non si è aggiornato. In questo caso l’errore “A Java Exception has occurred” è quello classico, e la soluzione non è installare Java a mano: è tornare sulla pagina ufficiale e scaricare lo ZIP corrente, che porta già tutto il necessario.

Hai installazioni Java residue da versioni precedenti del programma o da altri software gestionali che condividono il PC. Qui il conflitto è reale, perché il sistema operativo può risolvere java.exe verso un percorso diverso da quello che il Desktop Telematico si aspetta. Vale la pena disinstallare le versioni Java non più necessarie da Programmi e funzionalità e, se il problema persiste, controllare la variabile d’ambiente JAVA_HOME (spesso il colpevole è proprio lì, impostata da un’installazione precedente e mai ripulita).

Su questo punto le fonti in rete non sono del tutto concordi: alcune guide, scritte prima del passaggio allo ZIP, consigliano ancora di installare un JDK specifico (11 o versioni LTS successive) e di lanciare l’eseguibile con parametri che puntano esplicitamente al percorso di java.exe. Con la versione attuale, integrata di JRE, questo passaggio dovrebbe essere superfluo nella maggior parte dei casi — ma se lavori su un sistema con configurazioni particolari (postazioni condivise, criteri di gruppo aziendali, antivirus aggressivi) può ancora servire, e qui davvero dipende dal caso specifico più che da una regola generale.

Requisiti minimi, in breve

Un Windows 11 che soddisfa già i requisiti minimi del sistema operativo regge senza problemi il Desktop Telematico: l’applicazione è relativamente leggera e non ha bisogno di hardware dedicato. Più che le specifiche della macchina, quello che fa davvero la differenza nella pratica sono tre cose: spazio libero a sufficienza per l’archivio estratto e per i file che il programma scambia durante gli invii, una connessione stabile per gli aggiornamenti automatici, e permessi di amministratore locale per la prima installazione. Per cifre precise su RAM e spazio disco minimi, la fonte più affidabile resta la sezione Software del sito dell’Agenzia (FONTE: agenziaentrate.gov.it, sezione Desktop telematico), perché questi valori possono cambiare da una versione all’altra.

Domande frequenti

Devo installare Java separatamente su Windows 11 prima del Desktop Telematico? No, non più. Dalla versione 1.3.0 (novembre 2025) il pacchetto include già la JRE 8 necessaria al funzionamento. Se hai già Java installato per altri motivi, lascialo pure dov’è: non serve toglierlo, a meno che non causi conflitti specifici.

Meglio la versione a 32 o 64 bit? Su un PC Windows 11 recente, quasi certamente 64 bit: è lo standard ormai da anni. Scegli il 32 bit solo se sai per certo di lavorare su un sistema operativo a 32 bit, cosa piuttosto rara oggi.

Perché mi compare ancora “A Java Exception has occurred”? Quasi sempre perché il file scaricato è una versione vecchia (installer .exe pre-2025) oppure perché sul PC restano installazioni Java di installazioni precedenti in conflitto. Riscarica il pacchetto ZIP aggiornato dal sito ufficiale prima di modificare qualsiasi impostazione di sistema.

Il Desktop Telematico è gratuito? Sì, è distribuito gratuitamente dall’Agenzia delle Entrate, senza licenze né abbonamenti. Quello che eventualmente ha un costo è l’assistenza di terzi — commercialisti o consulenti informatici — per la configurazione iniziale, non il software in sé.

Posso installarlo senza avere ancora le credenziali Entratel o Fisconline? Sì, installazione e creazione dell’utenza locale del programma sono indipendenti dalle credenziali di accesso ai servizi telematici. Ti serviranno solo più avanti, quando dovrai configurare l’ambiente di sicurezza per gli invii veri e propri.

Una cosa che noto spesso lavorando con chi usa questo software tutti i giorni: il momento in cui si perde più tempo non è l’installazione in sé, ormai abbastanza lineare, ma il passaggio successivo — la gestione dell’ambiente di sicurezza e il migrare le chiavi da un PC vecchio a uno nuovo. Se stai cambiando macchina, conviene pianificare anche quel passaggio, non solo il download del programma.

Sources:

Possono interessarti