Come modificare in sicurezza la directory dei modelli Ollama

Imposta la variabile d'ambiente OLLAMA_MODELS sulla nuova directory, copia lì l'archivio attuale dei modelli, riavvia Ollama e dimostra che un modello noto funziona ancora. Conserva la vecchia directory finché la nuova posizione non supera tale prova e un nuovo riavvio.

Prima di spostare qualsiasi cosa, individua l'archivio attivo

La posizione predefinita dei modelli Ollama dipende dal sistema operativo: ~/.ollama/models su macOS, /usr/share/ollama/.ollama/models per l'installazione standard del servizio Linux e C:\Users\%username%\.ollama\models su Windows. Un valore OLLAMA_MODELS esistente sostituisce tali valori predefiniti.

Controlla l'ambiente del processo prima di presumere che sia attivo il valore predefinito. Verifica inoltre che la destinazione disponga di spazio libero sufficiente per una seconda copia temporanea. Uno spostamento che inizia eliminando la fonte non offre un rollback pulito quando si scopre un errore nelle autorizzazioni, nella configurazione del servizio o di battitura.

Copia la directory senza modificarne il layout interno

Arresta download e modelli in esecuzione, quindi copia nella destinazione il contenuto della directory attuale dei modelli. Preserva la struttura delle directory e i nomi dei file. L'archivio di Ollama non è una cartella di nomi descrittivi di modelli da riorganizzare a mano; i manifest fanno riferimento ai blob dei contenuti all'interno di tale layout.

# Destinazioni di esempio — scegli un percorso reale sulla tua macchina
/Volumes/AI-Library/Ollama/models       # macOS
/mnt/ai-library/ollama/models           # Linux
D:\AI-Library\Ollama\models             # Windows

Usa il normale strumento di copia della piattaforma e confronta in seguito il numero di file o gli hash. Non indirizzare il servizio verso una destinazione copiata a metà mentre la copia sottostante è ancora in modifica.

Imposta OLLAMA_MODELS dove il processo Ollama può leggerla

La variabile deve esistere nell'ambiente dell'applicazione o del servizio Ollama, non soltanto in una finestra del terminale che chiuderai in seguito.

• App macOS: chiudi Ollama, esegui launchctl setenv OLLAMA_MODELS "/Volumes/AI-Library/Ollama/models", quindi riapri l'app. La FAQ ufficiale osserva che l'app eredita le variabili d'ambiente tramite launchctl.
• Servizio systemd Linux: esegui systemctl edit ollama.service, aggiungi Environment="OLLAMA_MODELS=/mnt/ai-library/ollama/models" sotto [Service], quindi ricarica systemd e riavvia Ollama.
• App Windows: chiudi Ollama dalla barra delle applicazioni, aggiungi una variabile d'ambiente utente denominata OLLAMA_MODELS nelle Impostazioni di Windows, quindi riavvia l'app.

Su Linux, il programma di installazione standard esegue il servizio come utente ollama. La guida ufficiale richiede pertanto che tale utente disponga dell'accesso in lettura e scrittura alla destinazione; il suo esempio è sudo chown -R ollama:ollama <directory>. Scegli autorizzazioni adeguate al sistema anziché rendere la libreria scrivibile da chiunque.

Verifica la destinazione invece di fidarti dell'impostazione

1. Riavvia Ollama completamente.
2. Esegui ollama list e conferma la presenza di un modello noto.
3. Esegui quel modello con un prompt breve, quindi arrestalo normalmente.
4. Scarica un piccolo modello o controlla l'attività di modifica per confermare che i nuovi dati arrivino nella destinazione.
5. Riavvia ancora una volta e ripeti la prova con il modello noto.

Se l'elenco è inaspettatamente vuoto, fermati. Ricontrolla la variabile vista dal servizio, la proprietà della directory e se hai copiato i contenuti in una cartella models annidata di troppo. Il ripristino del valore d'ambiente precedente dovrebbe rimettere immediatamente in servizio il vecchio percorso.

Spostare i dati archiviati non equivale a conservarli

Una nuova directory può risolvere un problema di capacità o posizione, ma resta spazio attivo del runtime. Un'eliminazione accidentale, un guasto del filesystem o una pulizia troppo aggressiva possono colpire l'unica copia. Mantieni una strategia di recupero separata per i modelli che non puoi permetterti di scaricare, ricreare o riaddestrare.

Tensor Archive è utile dopo che puoi indicare i file correlati che intendi conservare. Archivia una famiglia locale completata, verificala e ripristinala in una posizione separata prima di considerare sacrificabile qualsiasi copia di lavoro. Non sostituisce OLLAMA_MODELS, non modifica il servizio e non finge che una modifica del percorso sia un backup.

Cosa leggere dopo

Per una mappa dei valori predefiniti e del comportamento degli override, consulta dove Ollama archivia i modelli. Se ora più strumenti puntano allo stesso disco, usa la checklist di conservazione della libreria locale di modelli prima di rimuovere le copie precedenti.