# Migrazione a Nextcloud — guida per gli utenti

Il servizio `owncloud.ego-gw.it` è stato migrato da ownCloud a Nextcloud. Il nome del servizio, i vostri file, le cartelle condivise e i link pubblici restano invariati. Cambia il software server e, di conseguenza, il client da installare sul vostro computer/telefono.

Questa guida spiega cosa fare nei tre scenari d'uso: browser web, client desktop, app mobile. Se usate solo WebDAV (mount su server di calcolo, Cyberduck, script), non dovete fare nulla: continua a funzionare come prima.

---

## 1. Accesso via browser web

Non serve fare niente di speciale.

- URL invariato: `https://owncloud.ego-gw.it`
- Login: stesse credenziali EGO/LDAP di prima
- Interfaccia: grafica nuova, ma logica d'uso equivalente (file, condivisi con me, link pubblici, impostazioni)

Se il browser mostra errori di cache o pagine vecchie, fate un refresh forzato (`Ctrl+Shift+R` su Windows/Linux, `Cmd+Shift+R` su Mac) oppure cancellate la cache del sito.

---

## 2. Client desktop — sostituzione

Il client ownCloud non è compatibile con Nextcloud. Va disinstallato e sostituito con il client Nextcloud. *I file già sincronizzati in locale non vanno persi*: il nuovo client li riaggancia al server senza riscaricare.

### Procedura generale (valida per Windows, macOS, Linux)

1. *Prima del cutover*: lasciare il client ownCloud attivo, verificare che la sincronizzazione sia completa (icona verde, nessun file pendente). In caso di dubbio, aprire il client, controllare la scheda "Attività" e attendere che non ci siano trasferimenti in corso.

2. *Prendere nota della cartella locale sincronizzata* (di solito `C:\Users\\ownCloud` su Windows, `~/ownCloud` su macOS/Linux). La userete al passo 6.

3. *Chiudere il client ownCloud* (menu → Esci, non solo chiudere la finestra).

4. *Disinstallare il client ownCloud*:
- Windows: Impostazioni → App → ownCloud → Disinstalla
- macOS: trascinare `ownCloud.app` dal Finder al Cestino
- Linux: tramite gestore pacchetti della distribuzione (`dnf remove owncloud-client`, `apt remove owncloud-client`, ecc.)

5. *Installare il client Nextcloud* scaricandolo da:
- https://nextcloud.com/install/#install-clients
- Link diretti ai download: https://nextcloud.com/install/#desktop
- Su Linux esistono anche pacchetti nativi della distribuzione (`dnf install nextcloud-client` su Fedora/Alma/Rocky, `apt install nextcloud-desktop` su Debian/Ubuntu), oppure AppImage, oppure Flatpak (`flathub: com.nextcloud.desktopclient.nextcloud`).

6. *Prima configurazione*:
- Avviare il client Nextcloud
- Alla richiesta dell'indirizzo del server, inserire: `https://owncloud.ego-gw.it`
- Login con credenziali EGO/LDAP (le stesse del web)
- Alla scelta della cartella locale, *selezionare la cartella già esistente* (quella annotata al passo 2). Il client chiederà conferma: accettare. Rileverà i file già presenti e li riassocerà al server tramite confronto di hash — nessun download massiccio, sincronizzerà solo le eventuali differenze.
- Scegliere quali cartelle sincronizzare (di default tutte).

### Note per macOS

- Se il client non si avvia dopo l'installazione per problemi di firma/notarizzazione, aprirlo con tasto destro → Apri, confermare l'eccezione di Gatekeeper una volta.
- Il client Nextcloud supporta i *Virtual Files* (file su richiesta, scaricati solo all'apertura) sia su macOS sia su Windows. Utile se la cartella sincronizzata è grande.

### Note per Windows

- Se il client ownCloud aveva un'integrazione shell (icone di stato su Esplora risorse), può restare registrata dopo la disinstallazione. In caso di icone fantasma, riavviare il PC dopo aver installato Nextcloud.
- I Virtual Files sono attivabili dalle impostazioni account del client Nextcloud.

### Note per Linux

- Il client Nextcloud da pacchetto distro può essere più vecchio del più recente upstream. Se serve una versione specifica, usare AppImage o Flatpak.
- Sugli ambienti desktop basati su Wayland qualche funzione dell'area di notifica può essere limitata: se l'icona non compare, verificare che l'estensione AppIndicator/StatusNotifier sia attiva.

---

## 3. App mobile — sostituzione

L'app ownCloud va sostituita con l'app Nextcloud.

1. *Disinstallare* l'app ownCloud dal telefono.
2. *Installare* l'app Nextcloud:
- iOS (App Store): https://apps.apple.com/app/nextcloud/id1125420102
- Android (Google Play): https://play.google.com/store/apps/details?id=com.nextcloud.client
- Android (F-Droid, build FOSS): https://f-droid.org/packages/com.nextcloud.client/
3. *Configurazione*:
- All'avvio, scegliere "Accedi" (non "Registrati")
- Server: `https://owncloud.ego-gw.it`
- Autenticazione: si apre una pagina web, login con credenziali EGO/LDAP, autorizzare l'app
4. I file non vengono scaricati automaticamente in massa: l'app mostra l'elenco e scarica su richiesta. Foto e documenti "preferiti" (stella) possono essere resi disponibili offline.

Se usavate il backup automatico delle foto (camera upload) dall'app ownCloud, riconfiguratelo nell'app Nextcloud (Impostazioni → Auto upload). Le foto già caricate non saranno ricaricate: l'app riconosce i file già presenti lato server.

---

## 4. Client WebDAV e integrazioni

Non serve fare nulla.

- Mount `davfs2` sui server di calcolo: continuano a funzionare con lo stesso URL
- Cyberduck, WinSCP, altri client WebDAV: stesso URL e credenziali
- Script che usano `curl` o librerie WebDAV: invariati
- URL WebDAV di riferimento: `https://owncloud.ego-gw.it/remote.php/dav/files//`

---

## 5. Link pubblici

Tutti i link pubblici creati in precedenza (`https://owncloud.ego-gw.it/index.php/s/` o `https://owncloud.ego-gw.it/s/`) continuano a funzionare senza modifiche: i token sono stati preservati durante la migrazione.

Se avete distribuito link via email o documenti, non serve rigenerarli.

---

## 6. Condivisioni ricevute

Tutte le condivisioni (file/cartelle condivisi con voi da altri utenti, condivisioni di gruppo) sono state migrate e si ritrovano nella sezione "Condivisi con te" dell'interfaccia web e, per chi lo usa, nel client desktop.

Nota: in Nextcloud le condivisioni dirette con utente (non i gruppi) richiedono un'accettazione esplicita la prima volta. La migrazione le ha pre-accettate per voi, quindi dovreste trovarle già disponibili.

---

## 7. OnlyOffice — editing documenti online

L'editing collaborativo di documenti Office (.docx, .xlsx, .pptx) via OnlyOffice continua a funzionare. Aprendo un documento dal browser o dal client, si apre nell'editor come prima. Se un documento non si apre o mostra un errore, riprovare dopo qualche minuto (il servizio può impiegare qualche istante a rispondere al primo accesso) e in caso contattare l'helpdesk.

---

## 8. Problemi frequenti e soluzioni

**Il client desktop dice "server non supportato" o "errore di connessione"**
State ancora usando il client ownCloud. Disinstallatelo e installate il client Nextcloud (sezione 2).

**Il client Nextcloud non accetta le credenziali**
Verificare username e password sul web (`https://owncloud.ego-gw.it`). Se il login web funziona ma il client no, riprovare usando il flusso di login via browser (opzione che si apre automaticamente nella procedura guidata del client).

**Dopo la configurazione del client, il sync sembra bloccato**
Controllare che la cartella locale scelta non sia sotto OneDrive/iCloud/Dropbox: due sync paralleli sulla stessa cartella si conflittano. Se è quello il caso, spostare la cartella fuori dal cloud concorrente.

**L'app mobile non ritrova le foto caricate prima**
Le foto ci sono sul server. Se non appaiono, forzare il refresh dell'app (tirare verso il basso nella lista) oppure uscire e rientrare.

**Un link pubblico ricevuto da un collega non funziona**
Se l'errore è "file not found", il file potrebbe essere stato spostato/cancellato dal proprietario. Chiedere di rigenerare il link. Se l'errore è un 502/503, è un problema temporaneo del servizio: riprovare tra qualche minuto.

**Ho file in "conflitto" dopo aver riconfigurato il client**
Succede quando il client ownCloud è stato chiuso con sync non completo prima della sostituzione. Il client Nextcloud segnala i file con versioni divergenti e li affianca (con suffisso `_conflict-...`). Aprire entrambi, scegliere la versione buona, cancellare l'altra.

---

## 9. Contatti

Per qualsiasi problema non coperto qui: service@ego-gw.it

Per segnalazioni urgenti legate al servizio: giuseppe.dibiase@ego-gw.it

---

## Link di riferimento

- Client desktop Nextcloud (tutte le piattaforme): https://nextcloud.com/install/#install-clients
- App Nextcloud per iOS: https://apps.apple.com/app/nextcloud/id1125420102
- App Nextcloud per Android (Play Store): https://play.google.com/store/apps/details?id=com.nextcloud.client
- App Nextcloud per Android (F-Droid): https://f-droid.org/packages/com.nextcloud.client/
- Documentazione utente Nextcloud (inglese): https://docs.nextcloud.com/server/latest/user_manual/en/
- Servizio EGO: https://owncloud.ego-gw.it