--- title: "Librerie esterne e strumenti di terze parti" description: "Perché le librerie esterne non sono disponibili su PixelUnion, quali alternative usare e cosa aspettarsi dagli strumenti di terze parti per Immich" url: "https://pixelunion.eu/it/help/immich/external-libraries-and-tools/" weight: 11 --- Se hai gestito Immich in autonomia, potresti essere abituato a funzionalità che si basano sull'accesso diretto al server, come le librerie esterne o gli strumenti che si collegano al database di Immich. Poiché PixelUnion è un servizio gestito, alcune di queste funzionano diversamente. Questo articolo spiega cosa è possibile e cosa no. ## Le librerie esterne non sono disponibili In un'installazione self-hosted di Immich, una **libreria esterna** permette a Immich di leggere le foto da una cartella già presente sul server o su un'unità montata, ad esempio una cartella condivisa di un NAS. Immich indicizza quei file dove si trovano, senza copiarli nel proprio spazio di archiviazione. Questa funzionalità **non è disponibile su PixelUnion**. Il tuo ambiente PixelUnion gira nel nostro data center e non ha accesso alle cartelle del tuo computer o NAS. Per lo stesso motivo, l'endpoint API `/api/library`, che gestisce le librerie esterne, è disabilitato. Al suo posto, tutte le foto e i video su PixelUnion si trovano in una normale **libreria gestita**: i file vengono caricati nel tuo ambiente e archiviati da PixelUnion. Questo significa anche che hai il pieno controllo su tutto il suo contenuto. Puoi modificare, spostare nel cestino ed eliminare qualsiasi foto, cosa che non è possibile con i file di sola lettura di una libreria esterna. ### Alternative Per portare su PixelUnion le foto di una cartella o di un NAS, caricale: - **Immich Go**: uno strumento a riga di comando che carica un'intera cartella in un colpo solo. Se lo esegui di nuovo più tardi, carica solo i file nuovi. Esempio: ``` ./immich-go upload from-folder --server=https://yourname.pixelunion.eu --api-key=YOUR_API_KEY /path/to/your/photos ``` Consulta [Migrare da un altro server Immich](/it/help/migrating/migrate-immich/) per sapere come scaricare Immich Go e creare una chiave API. - **L'app mobile**: esegui automaticamente il backup del rullino del telefono e di altre cartelle. Consulta [App Mobile](/it/help/immich/mobile-app/). - **L'interfaccia web**: trascina file o cartelle nel browser. Consulta [Caricare Foto](/it/help/immich/uploading-photos/). Hai già un tuo server Immich con una libreria esterna? Puoi trasferire quella libreria su PixelUnion con Immich Go, consulta [Migrare da un altro server Immich](/it/help/migrating/migrate-immich/). ## Usare l'API Immich e strumenti di terze parti Puoi usare l'API Immich con le tue chiavi API, quindi la maggior parte degli strumenti basati sull'API funziona con PixelUnion. Crea una chiave API in **Impostazioni account** → **Chiavi API**. Solo due endpoint sono disabilitati: `/api/library` (librerie esterne) e `/api/system-config` (configurazione del server). Alcuni strumenti di terze parti hanno bisogno di qualcosa in più dell'API. Si collegano direttamente al **database** di Immich o leggono il **file system** del server. PixelUnion non fornisce accesso diretto a nessuno dei due, quindi questi strumenti, o le loro funzionalità che ne dipendono, non funzioneranno. **Immich Power Tools** è un esempio: diverse sue funzionalità interrogano direttamente il database di Immich. Le funzionalità che usano solo l'API potrebbero funzionare, ma aspettati che una parte dello strumento non sia disponibile. Prima di affidarti a uno strumento di terze parti, controlla nella sua documentazione se richiede una connessione al database o l'accesso al file system. ### Rimuovere i duplicati senza strumenti aggiuntivi Immich ha un rilevamento dei duplicati integrato. Nell'interfaccia web, vai su **Utilità** → **Rivedi duplicati** per confrontare foto simili una accanto all'altra e scegliere quali conservare. I duplicati vengono rilevati per singolo utente, quindi le foto caricate da due utenti diversi non vengono confrontate tra loro. ## Mantenere la struttura degli album in un backup locale I tuoi dati vengono salvati da PixelUnion, consulta [Come eseguiamo il backup dei tuoi dati](/it/help/other/data-backups/). Se vuoi anche una tua copia locale, tieni presente che molti strumenti di download salvano i file, ma non gli album a cui appartengono. Ci sono alcuni modi per conservare i tuoi album: 1. **immich-archiver**: il nostro strumento di download scrive un file `.json` accanto a ogni foto e video, che include gli album a cui appartiene. Consulta [Scaricare Tutte le Foto e i Video](/it/help/immich/download-photos-videos/). 2. **Scaricare per album**: apri un album nell'interfaccia web e scaricalo. Ottieni un file ZIP con tutte le foto e i video di quell'album, ma senza informazioni sull'album oltre alla cartella stessa. 3. **Usare l'API**: l'API Immich restituisce tutti i tuoi album e le foto di ciascun album, quindi puoi scrivere un tuo script se ti serve una struttura diversa. ## Hai bisogno di aiuto? Non sai se uno strumento o un flusso di lavoro funzionerà con PixelUnion? [Contatta il nostro team di supporto](/it/support/) e ti aiuteremo a verificarlo.