Flatpak non accede ai file: come correggere i permessi su Linux

Se un’app Flatpak su Linux si apre ma non riesce a vedere una cartella, salvare un documento o leggere file da un disco, controlla prima i permessi della sandbox. Il problema può dipendere dalle autorizzazioni assegnate all’app, dagli override modificati dall’utente oppure dal selettore di file (portal). Non devi disattivare l’isolamento di Flatpak né concedere l’intero disco per risolverlo.

Questa guida riguarda app già installate tramite Flatpak. Se stai decidendo quale formato usare, consulta il nostro confronto tra Flatpak, Snap e AppImage; per un problema con il servizio Snap, invece, c’è la guida a Snap che non funziona su Ubuntu.

1. Capisci se il problema riguarda una sola app

Apri il programma e prova ad accedere a un file tramite il comando Apri dell’applicazione. Se il selettore grafico permette di scegliere il file, ma una cartella inserita manualmente non viene vista, potrebbe essere normale: molte app usano i portali desktop per ricevere accesso soltanto ai file selezionati. Se invece un’intera categoria di app non apre il selettore, verifica anche lo stato dei componenti xdg-desktop-portal della distribuzione prima di modificare singolarmente ogni applicazione.

2. Individua l’ID Flatpak dell’app

Apri il terminale e digita:

flatpak list --app

Cerca la colonna Application ID, ad esempio org.mozilla.firefox. Nei comandi seguenti APP_ID è un segnaposto: sostituiscilo sempre con l’identificativo reale della tua app. Non inserire letteralmente APP_ID aspettandoti che Flatpak scelga il programma corretto.

3. Controlla permessi e override senza modificarli

La documentazione ufficiale Flathub indica questi comandi per leggere le autorizzazioni attive e gli override personali:

flatpak info --show-permissions APP_ID
flatpak override --user --show APP_ID
flatpak override --user --show

L’ultimo comando mostra gli override globali dell’utente, validi per tutte le app. Se l’app è installata a livello di sistema, controlla anche:

flatpak override --system --show APP_ID
flatpak override --system --show

Salva o copia l’output prima di intervenire. Se il problema è comparso dopo aver cambiato un permesso in Flatseal, ripristina prima soltanto quella modifica. I comandi di lettura appena mostrati non concedono nuove autorizzazioni.

4. Correggi il permesso con Flatseal

Flatseal offre un’interfaccia grafica per esaminare e modificare le autorizzazioni delle app Flatpak. Aprilo, seleziona l’app che presenta il problema e controlla la sezione relativa al filesystem. Verifica se la cartella necessaria è stata esclusa o se l’app ha un override troppo restrittivo. La guida Flathub ai permessi spiega sia Flatseal sia l’alternativa da terminale.

Se hai bisogno solo di leggere documenti, valuta un accesso di sola lettura a quella cartella. Per il salvataggio servirà invece un’autorizzazione di scrittura appropriata. Dopo ogni modifica chiudi completamente l’app e riaprila: il nuovo permesso non deve essere giudicato mentre la vecchia istanza è ancora in esecuzione.

5. Alternativa da terminale: autorizza una sola cartella

Per una cartella personale specifica puoi usare un override limitato. Questo esempio autorizza solo la lettura della cartella Documenti tramite la variabile speciale prevista da Flatpak:

flatpak override --user --filesystem=xdg-documents:ro APP_ID

Se l’app deve anche modificare e salvare i documenti, serve un’autorizzazione di scrittura specifica. Valuta però prima il selettore di file integrato: i portali possono concedere l’accesso ai soli documenti scelti senza creare una regola permanente su tutta la cartella. Evita --filesystem=host o --filesystem=home come soluzione generica: ampliano l’accesso oltre quanto può essere necessario.

6. Quando ripristinare gli override

Se l’app funzionava prima di una serie di modifiche ai permessi, un ripristino può servire. Controlla di avere salvato gli override attuali e di non perdere autorizzazioni necessarie per altri file o dispositivi. Solo se vuoi eliminare tutti gli override utente della specifica applicazione, esegui:

flatpak override --user --reset APP_ID

Attenzione: questo comando non ripristina un singolo interruttore ma rimuove tutti gli override dell’app in quello scope. Non cancella automaticamente i documenti dell’utente, ma può cambiare l’accesso a cartelle, periferiche e servizi. Per configurazioni di sistema, non trasformare automaticamente il comando in una variante --system senza averne valutato gli effetti.

Se Flatpak continua a non vedere i file

Controlla dove è montata la cartella o l’unità esterna: permessi Linux, mount point, portali desktop e autorizzazioni Flatpak sono livelli distinti. Per dischi esterni verifica prima se l’unità è montata nel file manager e se l’utente può aprirla fuori dalla sandbox. Non attribuire a Flatpak un problema generale di filesystem.

Se invece l’app non parte affatto, il problema potrebbe riguardare runtime, aggiornamenti o una regressione del pacchetto: segui il ramo diagnostico della documentazione Flathub, invece di continuare ad allargare i permessi. Se vuoi chiedere aiuto, indica distribuzione, versione di Flatpak, Application ID, messaggio d’errore e permessi mostrati dai comandi, senza pubblicare percorsi privati o dati personali.

La verifica finale è semplice: l’app apre o salva il file necessario, mentre i permessi restano limitati alla cartella o alla funzione indispensabile. Quale app Flatpak ti sta dando problemi, e non riesce ad aprire i file oppure a salvarli?