← tutti gli articoli

Installare Bazzite sul OneXPlayer 1S: guida passo passo

2026-11-07 · Bazzite Linux Handheld Onexplayer Gaming Installazione Guida

Guida passo passo, aggiornata al 7 novembre 2026 dopo un'installazione reale: dalla preparazione di Windows fino ai giochi Epic nella Steam Gaming Mode.

In questa guida

  1. Verifica i requisiti (1.1)
  2. Prepara Windows e il materiale (2.1–2.5)
  3. Scarica l'immagine e crea la chiavetta (3.1–3.3)
  4. BIOS e avvio da USB (4.1–4.3)
  5. Installa Bazzite (5.1–5.5)
  6. Primo avvio (6.1–6.7, compresa la correzione dello schermo nero)
  7. Configura l'handheld (7.1–7.7, compresa la sincronizzazione di Google Drive)
  8. Giochi Epic nella Gaming Mode (8.1–8.5)
  9. Previeni i problemi futuri (9.1–9.7)
  10. Problemi noti e rollback
  11. Cosa non è verificato
  12. Fonti principali
Modello CPU / GPU RAM Disco
OneXPlayer 1S, 8.4" IPS i7-1195G7 / Iris Xe 16 GB 1 TB NVMe

Da sapere prima. Bazzite si installa su questo dispositivo, ma senza supporto ufficiale.

  • La pagina ufficiale sui OneXPlayer documenta solo il modello X1.
  • La grafica Iris Xe non è tra le GPU indicate per la Steam Gaming Mode (sono indicate GPU AMD moderne e Intel Arc).
  • Al primo avvio la Gaming Mode parte con lo schermo nero. Si risolve con una correzione manuale dalla console, descritta ai passaggi 6.2 e 6.3, verificata su questo dispositivo.
  • Anche il passaggio al desktop dal menu di Steam non funziona subito: la soluzione è al passaggio 6.6.

Fonti: OneXPlayer Handhelds, Hardware Compatibility for Gaming, issue #6240.

Accanto a ogni passaggio trovi l'indicazione di quanto è affidabile: Verificato (provato su questo dispositivo o confermato dalla documentazione ufficiale), Non verificato o Facoltativo.

1. Verifica i requisiti

Prima di toccare il dispositivo, controlla che l'hardware soddisfi i requisiti ufficiali.

1.1 Confronta l'hardware con i requisiti minimi

Verificato.

Requisiti ufficiali di Bazzite e situazione del tuo dispositivo:

Fonti: Hardware Compatibility for Gaming, Intel, articolo di supporto 000005524 "Supported APIs for Intel Graphics", specifiche OneXPlayer 1S.

2. Prepara Windows e il materiale

Questi passaggi si fanno ancora in Windows. Anche se poi sostituisci Windows, servono a non perdere dati e licenza.

2.1 Fai il backup dei dati

Verificato.

Copia su un disco esterno o nel cloud tutto ciò che vuoi tenere: documenti, salvataggi dei giochi non sincronizzati, foto. La guida ufficiale lo chiede prima di procedere.

Fonte: Installation Guide.

2.2 Metti al sicuro licenza Windows e driver

Non documentato da Bazzite.

Fonti: DROIX, driver OneXPlayer, FAQ Bazzite.

2.3 Disattiva BitLocker

Verificato.

In Windows apri Impostazioni → Privacy e sicurezza → Crittografia dispositivo (o Gestione BitLocker dal Pannello di controllo) e disattiva la crittografia. Prima annota la chiave di ripristino.

Fonte: guida handheld ufficiale.

2.4 Disattiva l'Avvio rapido di Windows

Verificato.

  1. Apri Pannello di controllo → Opzioni risparmio energia → Specifica comportamento pulsanti di alimentazione.
  2. Clicca Modifica le impostazioni attualmente non disponibili e togli la spunta da Attiva avvio rapido.
  3. Spegni il dispositivo con un normale arresto, non con l'ibernazione.

Bazzite avverte che l'Avvio rapido può bloccare alcuni componenti, come il Wi-Fi.

Fonte: Common Issues & Resolutions.

2.5 Procura il materiale

Verificato.

Fonti: Installation Guide, Troubleshooting Guide.

3. Scarica l'immagine e crea la chiavetta

3.1 Scegli l'immagine giusta

Scelta consigliata.

Sul sito ufficiale scegli Device: Handheld e poi Desktop: GNOME. Per gli handheld il sito non chiede la GPU: la scelta "Handheld" porta già a un'immagine con Steam Gaming Mode. Nella scheda New Users compare il pulsante Download bazzite-deck-gnome: è quello da usare.

Usa l'installer normale. Sotto il pulsante principale c'è anche il "Legacy installer". Il sito avverte che verrà dismesso presto e consiglia l'installer normale.

Per riferimento, le immagini disponibili:

Immagine Cosa offre Per te
bazzite-deck-gnome Steam Gaming Mode + desktop GNOME Consigliata. È l'unica con Gaming Mode funzionante documentata su un OneXPlayer Intel Tiger Lake.
bazzite-deck Steam Gaming Mode + desktop KDE Plausibile con la stessa correzione, non verificata.
bazzite Solo desktop KDE Ripiego se la Gaming Mode non funziona: Steam si avvia in Big Picture.
bazzite-gnome Solo desktop GNOME Ripiego alternativo.

Puoi cambiare immagine anche dopo, con un rebase (vedi Problemi noti e rollback).

Fonti: bazzite.gg, FAQ Bazzite, issue #6240.

3.2 Scarica la ISO e verifica il checksum

Verificato.

Scarica la ISO con il pulsante Download bazzite-deck-gnome. Accanto al pulsante ci sono le icone per la verifica del file: da lì ottieni lo SHA256 pubblicato. Poi confrontalo con quello del file scaricato, da PowerShell (sostituisci il nome con quello del file scaricato):

Get-FileHash .\nome-del-file.iso -Algorithm SHA256

Fonte: Installation Guide.

3.3 Scrivi la chiavetta con Rufus

Strumento ufficiale.

Rufus è tra gli strumenti indicati dalla guida ufficiale di Bazzite, ma la documentazione non dice quali impostazioni usare. Quelle qui sotto derivano dai requisiti di Bazzite e dalle indicazioni dell'autore di Rufus. Tra parentesi trovi l'etichetta inglese, se Rufus è in inglese.

  1. Scarica Rufus dal sito ufficiale rufus.ie e avvialo. Collega la chiavetta: il suo contenuto verrà cancellato.
  2. Dispositivo (Device): seleziona la chiavetta. Controlla bene di non scegliere un disco esterno con dati.
  3. Selezione boot (Boot selection): "Disco o immagine ISO", poi SELEZIONA e scegli il file bazzite-deck-gnome scaricato.
  4. Schema partizione e sistema destinazione: se sono modificabili, scegli GPT e UEFI (non CSM), perché Bazzite non supporta l'avvio Legacy/CSM. Se sono grigi, lasciali così (vedi la nota qui sotto).
  5. Etichetta volume, file system e dimensione cluster: lascia i valori proposti da Rufus.
  6. Premi AVVIA (START). Se Rufus chiede in che modalità scrivere l'immagine, scegli la modalità immagine ISO (ISO Image mode), quella consigliata da Rufus.
  7. Conferma l'avviso di cancellazione e attendi la fine. Poi espelli la chiavetta in modo sicuro.

Opzioni grigie? È normale. Con la ISO di Bazzite Rufus 4.15 blocca schema partizione, sistema destinazione, file system ed etichetta (mostrando MBR, BIOS o UEFI CSM, FAT32). Significa che scriverà l'immagine in modalità DD, come copia esatta della ISO: la chiavetta riceve la partizione di avvio UEFI già presente nella ISO e i valori mostrati non vengono applicati. Lascia tutto così e premi AVVIA. Dopo la scrittura Windows potrebbe proporti di formattare la chiavetta: non farlo.

Se la chiavetta non si avvia. Riscrivila scegliendo la modalità immagine DD (DD Image mode), che copia la ISO byte per byte. L'autore di Rufus consiglia di provare prima la modalità ISO e passare alla DD solo in caso di problemi. Un utente Bazzite riporta di aver installato con la modalità DD. In modalità DD le opzioni di schema partizione vengono ignorate, ed è normale.

Evita Ventoy. La guida attuale lo ammette con passaggi extra per il Secure Boot, mentre le guide precedenti lo sconsigliavano del tutto. L'alternativa consigliata dalla guida ufficiale è Fedora Media Writer.

Fonti: Installation Guide, autore di Rufus su ISO e DD mode, utente Bazzite con DD mode.

4. BIOS e avvio da USB

Collega hub, chiavetta e tastiera al OneXPlayer prima di accenderlo.

4.1 Entra nel BIOS

Non ufficiale per l'8.4".

Nessun manuale ufficiale copre l'8.4" 1S. Prova queste combinazioni, con la tastiera USB collegata:

Fonti: FAQ OneXPlayer, OneXPlayer wiki.

4.2 Controlla le impostazioni del BIOS

Da controllare.

Attenzione al dual boot. Se Windows è installato con VMD attivo, disattivare VMD può impedire a Windows di avviarsi.

Fonti: Troubleshooting Guide, Secure Boot, Intel, VMD.

4.3 Avvia dalla chiavetta

Fonte DROIX.

  1. Accendi il dispositivo.
  2. Quando compare il logo, premi insieme DESKTOP + Volume +.
  3. Nel menu di avvio scegli la chiavetta con il D-Pad e conferma con START. L'SSD interno compare come "UEFI OS (One-netbook PCI-E 1TB SSD)": non è quello.

Fonte: DROIX, guida OneXPlayer 1165G7/1185G7/1195G7.

5. Installa Bazzite

Non serve la connessione a Internet per installare.

5.1 Prova la sessione live

Facoltativo.

La sessione live permette di vedere se schermo, touch e Wi-Fi rispondono prima di installare. Non usarla per giocare: usa un kernel diverso da quello installato.

Già da qui puoi leggere il nome del modello, utile più avanti:

cat /sys/class/dmi/id/product_name

Fonte: Installation Guide.

5.2 Imposta lingua, regione e tastiera

Apri l'installer e scegli italiano per lingua, fuso orario e layout di tastiera.

5.3 Scegli il disco e il partizionamento

Verificato.

Solo Bazzite. Seleziona l'SSD interno da 1 TB e usa il partizionamento automatico.

Cancella tutto. Questa scelta cancella tutti i dati sul disco selezionato, Windows compreso.

Dual boot con Windows.

  1. Prima, in Windows, riduci la partizione di Windows con Gestione disco per liberare almeno 50 GB (consigliati 120 GB o più).
  2. Nell'installer seleziona l'SSD e usa il partizionamento automatico, l'unica opzione disponibile nella ISO live: userà lo spazio libero.
  3. Dopo l'installazione aggiungerai Windows al menu di avvio (passaggio 6.7).

Bug noto dell'installer. Il pulsante "format as efi" dice che formatterà la partizione EFI di Windows, ma in realtà vi si aggiunge.

Alternativa più isolata. La vecchia guida raccomandava una partizione EFI separata, così gli aggiornamenti di Windows non toccano Bazzite. Oggi richiede la ISO legacy con partizionamento manuale, che il sito dichiara in via di dismissione. Il OneXPlayer ha un solo slot M.2: un'altra strada è Windows-to-Go su disco esterno, creato con Rufus.

Non condividere la libreria giochi su una partizione NTFS o exFAT: Bazzite non le supporta per giocare.

Fonti: Installation Guide, Dual boot, Hardware Compatibility.

5.4 Crea l'utente e decidi sulla cifratura

Fonte: Installation Guide.

5.5 Avvia l'installazione e riavvia

Avvia l'installazione. Al termine riavvia e rimuovi la chiavetta. Tieni collegata la tastiera: servirà per la chiave Secure Boot e per la console del passaggio 6.2.

6. Primo avvio

6.1 Registra la chiave Secure Boot (MOK)

Verificato.

Al riavvio compare una schermata blu, MokManager:

  1. Scegli Enroll MOK, poi Continue.
  2. Inserisci la password universalblue.
  3. Conferma e riavvia.

Due trappole. La schermata usa sempre il layout inglese QWERTY, e i caratteri digitati non vengono mostrati.

Se la schermata non compare o vedi l'errore "bad shim signature", segui il metodo alternativo:

  1. Disattiva Secure Boot nel BIOS e avvia Bazzite.
  2. Apri un terminale ed esegui il comando qui sotto, inserendo universalblue.
  3. Riavvia nel BIOS con ujust bios, riattiva Secure Boot.
  4. Al riavvio completa Enroll MOK con la stessa password.
ujust enroll-secure-boot-key

Un aggiornamento del BIOS può riattivare Secure Boot: in quel caso ripeti il metodo alternativo.

Fonte: Secure Boot.

6.2 Se lo schermo resta nero, apri la console

Verificato su questo dispositivo.

Dopo il logo di Bazzite parte la Gaming Mode. Su questo modello lo schermo interno resta nero, anche se si sentono i suoni dell'interfaccia di Steam. Su questo dispositivo anche uno schermo esterno via USB-C è rimasto nero. Per applicare la correzione serve quindi la console testuale:

  1. Con la tastiera USB collegata, premi Ctrl + Alt + F3. Se non succede nulla, prova F2 o F4. Su una tastiera compatta può servire anche Fn.
  2. Accedi con il nome utente e la password creati durante l'installazione. Mentre digiti la password non compare nulla: è normale.

Com'è fatta la console.

  • Il testo appare ruotato, perché il pannello è montato in verticale: tieni il dispositivo in verticale per leggerlo. I comandi di rotazione della console non hanno effetto.
  • Non si può scorrere all'indietro. Per leggere un output lungo aggiungi | less in fondo al comando: scorri con le frecce ed esci con q.
  • Per uscire scrivi exit. Per tornare alla schermata grafica premi Ctrl + Alt + F1 (o F2).

Fonti: issue #6240, forum Universal Blue, Phoronix, scorrimento console.

6.3 Applica la correzione dello schermo nero

Verificato su questo dispositivo.

Su Tiger Lake il display engine non riesce a ruotare di 90° le immagini compresse, e il pannello del OneXPlayer è montato in verticale. Nella console esegui, premendo Invio dopo ogni riga:

mkdir -p ~/.config/environment.d
echo "INTEL_DEBUG=norbc" >> ~/.config/environment.d/10-gamescope-session.conf
cat ~/.config/environment.d/10-gamescope-session.conf

L'ultimo comando deve mostrare la riga INTEL_DEBUG=norbc. Poi riavvia:

systemctl reboot

Al riavvio la Gaming Mode compare sullo schermo interno, nel verso giusto.

Se non basta. Su un altro Tiger Lake (GPD Win 3) ha funzionato aggiungere --force-composition-rotation al comando di gamescope (issue #6156). Non è verificato sul OneXPlayer.

Fonte: issue #6240.

6.4 Controlla nome del modello e versione Vulkan

Facoltativo.

Puoi farlo nella stessa console, prima di riavviare.

cat /sys/class/dmi/id/product_name

Su questo dispositivo risponde ONE XPLAYER: lo stesso nome del modello dell'issue #6240.

vulkaninfo | grep 'Instance Version'

Su questo dispositivo risponde 1.4.350, sopra il requisito di 1.3. Le righe WARNING che compaiono prima si possono ignorare.

Fonti: device-quirks, Hardware Compatibility.

6.5 Accedi a Steam

Con lo schermo funzionante, accedi con il tuo account Steam e riavvia dal menu di accensione di Steam.

Fonte: guida handheld ufficiale.

6.6 Fai funzionare il passaggio al desktop

Verificato su questo dispositivo.

Su questo dispositivo Passa al desktop dal menu di Steam fa diventare nero lo schermo e riporta alla Gaming Mode. È un problema noto, segnalato su altri handheld con la stessa sessione di gioco (gamescope-session-ogui-steam). Si risolve dalla console (Ctrl + Alt + F3):

  1. Indica a Steam quale desktop avviare. Se non sei sicuro del nome, controllalo con ls /usr/share/wayland-sessions/.

    steamosctl set-default-desktop-session gnome.desktop

  2. Imposta il desktop come modalità di avvio e riavvia:

    steamosctl set-default-login-mode desktop
systemctl reboot

Non riavviare solo SDDM. Un workaround segnalato online suggerisce sudo systemctl restart sddm al posto del riavvio. Su questo dispositivo ha bloccato la console. Se succede, tieni premuto il pulsante di accensione per circa 10 secondi e riaccendi: al riavvio parte il desktop.

Per tornare alla Gaming Mode (le modalità ammesse sono solo game e desktop):

steamosctl switch-to-game-mode

Passa subito alla Gaming Mode, senza cambiare la modalità di avvio.

steamosctl set-default-login-mode game

Rimette la Gaming Mode come modalità di avvio. Si applica al riavvio successivo.

Con steamosctl get-default-login-mode vedi quale modalità è impostata. Attento a scrivere bene steamosctl: un errore di battitura dà "command not found".

Fonti: issue #6199, issue #6039, DeepWiki, selezione sessione.

6.7 Aggiungi Windows al menu di avvio (solo dual boot)

Solo dual boot.

ujust regenerate-grub

Aggiunge Windows al menu GRUB.

ujust setup-boot-windows-steam

Facoltativo: crea in Steam una voce che riavvia in Windows.

Fonte: comandi ujust.

7. Configura l'handheld

7.1 Sistema orientamento e scala nel desktop

Se al primo avvio il desktop GNOME ha orientamento o scala sbagliati, correggili in Impostazioni → Schermi. Su un OneXPlayer Intel GNOME risulta già nel verso giusto. In alternativa, dal Terminale:

gdctl show

Mostra il nome dello schermo interno, di solito eDP-1.

gdctl set --logical-monitor --primary --monitor eDP-1 --transform 90

Se l'immagine è capovolta usa 270. Aggiungi --persistent dopo set per mantenerla. Scollega prima gli schermi esterni.

Per duplicare lo schermo su un monitor esterno premi Super + P più volte finché compare il mirror.

Fonti: guida handheld, gdctl, GNOME, Super+P.

7.2 Prova i controlli integrati

Da provare.

Bazzite gestisce i controlli degli handheld con InputPlumber, che ha un profilo per i OneXPlayer Intel. Le sue regole riconoscono il nome "ONE XPLAYER", che è quello riportato da questo dispositivo, quindi i controlli dovrebbero essere riconosciuti. Che funzionino tutti non è ancora verificato.

Se i controlli non vanno, apri una segnalazione su GitHub citando l'issue #6240.

Fonti: Handheld Wiki, InputPlumber, note ChimeraOS.

7.3 Scegli un solo metodo per il TDP

Non verificato sul 1S.

Le strade possibili sono tre. Usane una sola alla volta, come raccomanda la documentazione:

  1. menu rapido di Steam, icona fulmine, sezione TDP (solo se il dispositivo è gestito da SteamOS Manager);
  2. OpenGamepadUI / PowerStation;
  3. un plugin Decky, come SimpleDeckyTDP.

Non ho trovato conferme che il TDP del 1S Intel sia regolabile in Bazzite.

Fonte: Handheld Wiki.

7.4 Installa Decky Loader

Facoltativo.

ujust setup-decky

Decky si apre dal menu rapido. Può rompersi o disinstallarsi dopo un aggiornamento: in quel caso ripeti il comando.

Fonte: Handheld Wiki.

7.5 Aggiorna e blocca la versione funzionante

Verificato.

Sulle immagini Deck gli aggiornamenti automatici sono spenti. Aggiorna con l'app Bazzite Updater (usabile col controller) oppure:

ujust update

Aggiorna sistema, app Flatpak e container. Serve almeno il 3% di spazio libero.

Quando tutto funziona, blocca questa versione: la trovi al passaggio 9.2. Le app si installano da Bazaar. Con ujust --choose vedi tutti i comandi di configurazione. Evita rpm-ostree install: può bloccare gli aggiornamenti.

Fonti: Update Guide, rpm-ostree.

7.6 Installa Mullvad VPN

Facoltativo.

Mullvad non ha una versione Flatpak ufficiale, quindi va aggiunto al sistema con rpm-ostree. La documentazione di Bazzite sconsiglia questo metodo perché può bloccare gli aggiornamenti: per questo il primo passo è bloccare la versione attuale. Esegui i comandi dal Terminale del desktop.

  1. Blocca la versione del sistema in uso, così puoi tornare indietro (vedi 9.2):

    sudo ostree admin pin 0

  2. Aggiungi il repository ufficiale di Mullvad. Prima controlla che l'indirizzo corrisponda a quello indicato per Fedora nelle istruzioni ufficiali di Mullvad sul sito mullvad.net:

    curl -fsSL https://repository.mullvad.net/rpm/stable/mullvad.repo | sudo tee /etc/yum.repos.d/mullvad.repo

  3. Installa l'app e riavvia:

    rpm-ostree install mullvad-vpn
systemctl reboot

  4. Attiva il servizio di Mullvad, che dopo l'installazione resta spento:

    sudo systemctl enable --now mullvad-daemon.service

  5. Apri l'app Mullvad VPN dal menu delle applicazioni e inserisci il numero di account. Se vuoi che si connetta da sola, attiva la connessione automatica nelle impostazioni dell'app.

Da sapere. La VPN gira come servizio di sistema, quindi dovrebbe restare attiva anche in Gaming Mode. L'app grafica si apre solo dal desktop. Se un aggiornamento di Bazzite fallisce per colpa del pacchetto aggiunto, disinstallalo con rpm-ostree uninstall mullvad-vpn e riavvia.

Fonti: Adding Mullvad to Bazzite, Fedora Discussion, Mullvad issue #5639, rpm-ostree.

7.7 Sincronizza cartelle di Google Drive con rclone

Facoltativo. Non verificato su questo dispositivo.

Per avere una copia locale di alcune cartelle di Google Drive (anche condivise), modificabile in entrambe le direzioni, la soluzione adatta è rclone con la funzione bisync: tiene allineata una cartella locale con una cartella di Drive in entrambi i sensi e può girare in automatico a intervalli regolari. Va bene per quantità di dati contenute (qui meno di 10 GB) e con un account Google gratuito.

Due avvertenze.

  • bisync è ancora in beta. La documentazione la definisce una funzione avanzata da usare con cautela. Per questo il primo giro si fa in prova, con --dry-run.
  • I documenti nativi di Google (Documenti, Fogli, Presentazioni) non si sincronizzano bene: hanno dimensione −1 e nessun checksum, quindi si escludono con --drive-skip-gdocs. I file normali (PDF, Word, immagini e simili) si sincronizzano senza problemi.

Perché non l'account Google di GNOME. Gli Account online di GNOME mostrano Drive solo online, senza una copia locale, quindi non servono a questo scopo.

1. Prepara gli ID delle cartelle. Per poter rimandare su Drive le tue modifiche devi essere Editor delle cartelle condivise. Apri ogni cartella condivisa nel browser su drive.google.com (se è condivisa con te, la trovi in Condivisi con me: entraci con un doppio clic). L'ID è la parte dell'indirizzo dopo /folders/, senza eventuali code come ?usp=sharing. Per esempio, in questo indirizzo:

https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz012345

l'ID è 1AbCdEfGhIjKlMnOpQrStUvWxYz012345. Annotali.

2. Installa rclone. Dal Terminale controlla se c'è già:

rclone version

Se risponde "command not found", installalo con Homebrew, che su Bazzite è disponibile (meglio di rpm-ostree install, che può bloccare gli aggiornamenti):

brew install rclone

3. Crea il tuo client id Google. Il client id condiviso di rclone sta per essere ritirato: Google farà pagare le richieste fatte con quello integrato e rclone lo disattiverà nel corso del 2026 (l'annuncio parla di 90 giorni di preavviso, senza una data certa). Perciò conviene crearne uno proprio fin dall'inizio; è gratuito. I passaggi sotto sono quelli della documentazione rclone: i nomi dei menu nella console Google possono differire un po'.

  1. Accedi alla Google API Console con il tuo account Google e crea un progetto (Select a project > New project).
  2. In Enable APIs and services cerca "Drive" e abilita Google Drive API.
  3. Apri Credentials dal pannello a sinistra. Non usare "Create credentials": apre una procedura guidata. Clicca invece su Configure consent screen > Get started.
  4. Inserisci un nome per l'applicazione (va bene "rclone") e la tua email di assistenza. In Audience scegli External, inserisci l'email di contatto, accetta i termini e clicca su Create.
  5. In Data Access scegli Add or remove scopes (o Manually add scopes), aggiungi questi scope e salva: https://www.googleapis.com/auth/docs, https://www.googleapis.com/auth/drive e, facoltativo, https://www.googleapis.com/auth/drive.metadata.readonly.
  6. In Audience clicca su + Add users, aggiungi il tuo account Google e salva (utente di prova).
  7. In Overview clicca su Create OAuth client, scegli il tipo di applicazione Desktop app e clicca su Create. Annota client ID e client secret.
  8. In Audience clicca su Publish app e conferma. Se il pulsante è grigio, compila prima Branding (pagina iniziale, informativa sulla privacy, dominio autorizzato), salva e torna in Audience.

Se lasci l'app in stato "Testing" funziona, ma l'autorizzazione scade dopo circa una settimana e la sincronizzazione automatica si ferma: per questo si pubblica l'app.

4. Collega il tuo account Google.

rclone config

Rispondi così:

Se avevi già creato il remote gdrive lasciando vuoti client_id e client_secret, aggiornalo con i tuoi (sostituisci i due valori) e ricollegalo, rispondendo y alla richiesta di aggiornare il token: senza questo passo rclone continua a usare il client id condiviso.

rclone config update gdrive client_id TUO_CLIENT_ID client_secret TUO_CLIENT_SECRET
rclone config reconnect gdrive:

5. Primo allineamento, cartella per cartella. Per ogni cartella condivisa (qui Progetto è un nome di esempio e ID_CARTELLA va sostituito con l'ID vero):

mkdir -p ~/GoogleDrive/Progetto
rclone bisync ~/GoogleDrive/Progetto gdrive: --drive-root-folder-id ID_CARTELLA --drive-skip-gdocs --create-empty-src-dirs --resilient --recover --conflict-resolve newer --resync --dry-run -v

6. Sincronizzazione automatica ogni 15 minuti. Crea lo script ~/.local/bin/drive-sync.sh, con una riga rclone bisync per ogni cartella:

#!/bin/bash
export PATH="/home/linuxbrew/.linuxbrew/bin:$PATH"
OPTS="--drive-skip-gdocs --create-empty-src-dirs --resilient --recover --conflict-resolve newer --max-lock 2m --log-file $HOME/.cache/drive-sync.log -v"
rclone bisync "$HOME/GoogleDrive/Progetto" gdrive: --drive-root-folder-id ID_CARTELLA $OPTS

Crea il file ~/.config/systemd/user/drive-sync.service:

[Unit]
Description=Sincronizza cartelle Google Drive

[Service]
Type=oneshot
ExecStart=%h/.local/bin/drive-sync.sh

E il file ~/.config/systemd/user/drive-sync.timer:

[Unit]
Description=Sincronizza Google Drive ogni 15 minuti

[Timer]
OnBootSec=2min
OnUnitActiveSec=15min

[Install]
WantedBy=timers.target

Poi rendi eseguibile lo script e attiva il timer:

chmod +x ~/.local/bin/drive-sync.sh
systemctl --user daemon-reload
systemctl --user enable --now drive-sync.timer

Se qualcosa non va, il registro si trova in ~/.cache/drive-sync.log.

Sicurezze già incluse

Fonti: rclone bisync, documentazione, rclone Google Drive, documentazione, Bisync of Googledocs on googledrive, forum rclone, Syncing all Google Drive folders, owned and shared, forum rclone, annuncio sul ritiro del client id condiviso, forum rclone.

8. Giochi Epic nella Gaming Mode

Bazzite non integra Epic direttamente. La documentazione consiglia Heroic Games Launcher per i giochi Epic, GOG e Amazon. Tutto questo richiede che la Gaming Mode funzioni (passaggio 6.3).

8.1 Installa Heroic da Bazaar

Verificato.

Heroic non è preinstallato. Passa al Desktop Mode, apri Bazaar, cerca Heroic Games Launcher e installalo. È lo stesso pacchetto pubblicato su Flathub.

Fonti: Introduction to Gaming, Installing Software, forum Universal Blue.

8.2 Accedi a Epic e scarica un gioco

In Heroic scegli Login → Epic Games, accedi con il tuo account e installa un gioco dalla libreria.

Fonte: Heroic Games Launcher.

8.3 Avvialo una prima volta nel Desktop Mode

Molti giochi Epic installano dei prerequisiti al primo avvio, di solito un Visual C++ redistributable o un launcher proprio. Lascia che finiscano prima di tornare alla Gaming Mode.

Fonte: heldgames.

8.4 Porta i giochi nella Gaming Mode

Hai due possibilità, anche combinabili:

Torna alla Gaming Mode: trovi tutto in Libreria → Non di Steam.

Fonti: guida Epic su Steam Deck, GamingOnLinux.

8.5 Imposta i controlli e controlla l'anti-cheat

9. Previeni i problemi futuri

Gli aggiornamenti di Bazzite, del BIOS e di Windows sono i momenti in cui qualcosa può rompersi. Questi passaggi ti lasciano sempre una strada per tornare indietro.

9.1 Prepara un kit di emergenza

Consiglio.

cat ~/.config/environment.d/10-gamescope-session.conf

Fonti: forum Universal Blue, Rollbacks.

9.2 Blocca la versione che funziona

Verificato.

Bazzite conserva solo 2 versioni del sistema: a ogni aggiornamento cancella la più vecchia. Se ne blocchi una con il pin, non viene mai cancellata.

  1. Controlla l'indice della versione in uso (gli indici cambiano dopo ogni aggiornamento):

    rpm-ostree status -v

  2. Blocca la versione corrente (indice 0):

    sudo ostree admin pin 0

Quando una versione più nuova ha funzionato bene per un po', puoi sbloccare quella vecchia con sudo ostree admin pin -u seguito dal suo indice, così liberi spazio.

Fonte: Rolling back system updates.

9.3 Segui una routine per ogni aggiornamento

Verificato.

Sulle immagini Deck gli aggiornamenti automatici sono spenti, quindi decidi tu quando aggiornare. Ogni volta:

  1. Controlla di avere almeno il 3% di spazio libero sul disco.
  2. Aggiorna da Steam (Impostazioni → Sistema → Controlla aggiornamenti), da Bazzite Updater o con ujust update.

  3. Prima di riavviare, guarda cosa cambia. Il comando mostra le differenze di pacchetti tra la versione attuale e quella in attesa:

    rpm-ostree db diff

  4. Riavvia: l'aggiornamento di sistema si applica solo al riavvio.

  5. Prova subito Gaming Mode, controlli e un gioco. Se qualcosa non va, torna indietro (vedi Problemi noti e rollback).
  6. Se tutto va bene per qualche giorno, blocca la nuova versione (passaggio 9.2).

Fonte: Update Guide.

9.4 Tieni il sistema pulito

Verificato.

Fonti: rpm-ostree, Handheld Wiki, Hardware Compatibility.

9.5 Dopo un aggiornamento del BIOS, controlla Secure Boot

Da ricordare.

Un aggiornamento del BIOS può riattivare Secure Boot o ripristinare le impostazioni, e Bazzite può non avviarsi più. Per controllare che la chiave di Bazzite sia ancora registrata (elenca le chiavi MOK registrate):

sudo mokutil -l

Se Bazzite non parte più, disattiva Secure Boot nel BIOS, avvia Bazzite e registra di nuovo la chiave con il metodo alternativo del passaggio 6.1. Un utente del forum ha risolto proprio così un blocco dopo un aggiornamento del BIOS.

Fonti: Secure Boot, guida dual boot del forum, segnalazione sul forum.

9.6 Dopo un aggiornamento di Windows, controlla l'avvio (solo dual boot)

Solo dual boot.

ujust regenerate-grub

Un utente del forum segnala che un aggiornamento di Windows con Secure Boot attivo può impedire l'avvio di versioni vecchie di GRUB. Tenere Bazzite aggiornato riduce il rischio.

Fonte: guida dual boot del forum Universal Blue.

9.7 Segui la segnalazione sullo schermo nero

Consiglio.

Apri l'issue #6240 e, con un account GitHub, usa Subscribe per ricevere notifiche. Saprai quando la correzione viene integrata nell'immagine o se gli sviluppatori propongono un'altra soluzione.

Problemi noti e rollback

Problemi noti

Tornare alla versione precedente

rpm-ostree rollback

brh rollback

Il secondo comando usa Bazzite Rollback Helper: brh list mostra le immagini degli ultimi 90 giorni.

Cambiare immagine (per esempio da Deck a Desktop): usa brh rebase o il Bazzite Portal. Non passare a un ambiente desktop diverso da quello in uso.

Fonti: Rollbacks, Rollback Helper, SteamOS Comparison.

Cosa non è verificato

Fonti principali

Guida basata sulla documentazione disponibile al 7 novembre 2026: verifica sempre le pagine ufficiali prima di procedere.