Il tuo Desktop, nel browser.

1. Prepara l’host

La release Docker avvia il bundle Linux in un desktop leggero accessibile tramite noVNC. Servono Docker installato e attivo, spazio per immagine e dati e una connessione Telegram funzionante.

1. Verifica Docker sul computer o server su cui vuoi eseguire Teledisk.
2. Scarica lo script ufficiale e leggilo prima di eseguirlo.
3. Prepara l’accesso al browser dell’host e proteggi la porta noVNC nella tua rete.

2. Installa e apri noVNC

Lo script ufficiale prova il registry e può usare il tarball pubblicato sul sito come fallback. Su Linux usa normalmente la rete host; su Docker Desktop può essere necessario il bridge.

1. Scarica teledisk-docker-run.sh dal centro download e controllane il contenuto.
2. Esegui lo script sull’host e attendi il caricamento dell’immagine.
3. Apri http://localhost:6080/vnc.html?autoconnect=1&resize=remote sullo stesso host.

Non esporre noVNC direttamente su Internet senza un controllo di accesso adeguato.

3. Docker Compose e Portainer

I file Compose e Portainer ufficiali descrivono il container e i suoi volumi. Se l’immagine non è disponibile nel registry, lo script può caricarla prima del deploy.

1. Scarica lo script e avvialo con TELEDISK_DOCKER_LOAD_ONLY=1 per preparare l’immagine.
2. Per Compose scarica teledisk-docker-compose.yml e avvia docker compose -f teledisk-docker-compose.yml up -d.
3. Per Portainer apri Stacks → Add stack, usa il file ufficiale teledisk-portainer-stack.yml e distribuisci lo stack.

4. Dati persistenti e download

Il volume teledisk-data conserva dati e configurazione. La cartella locale ~/TelediskDownloads è montata in /downloads. Ricreare il container non deve comportare la rimozione del volume.

1. Verifica il mount dei dati e la cartella download nella configurazione usata.
2. Configura l’account dentro l’interfaccia noVNC e prova un download in /downloads.
3. Prima degli aggiornamenti arresta correttamente l’app e conserva una copia coerente del volume.

Il volume può contenere sessioni Telegram e configurazioni personali: proteggilo come una credenziale e non pubblicarlo in Git.

5. Verifica e risolvi i problemi

Se il browser non apre noVNC, controlla prima container e rete. Se l’interfaccia si apre ma Telegram non risponde, verifica connettività e accesso dentro l’app.

1. Controlla lo stato del container e i log nell’interfaccia Docker o Portainer.
2. Verifica porta 6080, firewall e conflitti con altri servizi dell’host.
3. Se usi bridge, verifica DNS e rete; segui la modalità prevista per il tuo host.