Como alterar o diretório de modelos do Ollama em segurança

Defina a variável de ambiente OLLAMA_MODELS para o novo diretório, copie para lá o armazenamento atual de modelos, reinicie o Ollama e comprove que um modelo conhecido continua a funcionar. Conserve o diretório antigo até o novo local passar esse teste e um novo reinício.

Antes de mover qualquer elemento, localize o armazenamento ativo

A localização predefinida dos modelos do Ollama depende do sistema operativo: ~/.ollama/models no macOS, /usr/share/ollama/.ollama/models para a instalação normal do serviço Linux e C:\Users\%username%\.ollama\models no Windows. Um valor OLLAMA_MODELS existente substitui essas predefinições.

Verifique o ambiente do processo antes de presumir que a predefinição está ativa. Confirme também que o destino tem espaço livre suficiente para uma segunda cópia temporária. Uma mudança que começa por eliminar a origem não oferece uma reversão simples se as permissões, a configuração do serviço ou uma gralha estiverem erradas.

Copie o diretório sem alterar a sua disposição interna

Pare as obtenções e execuções de modelos ativas e depois copie o conteúdo do diretório atual de modelos para o destino. Preserve a estrutura do diretório e os nomes dos ficheiros. O armazenamento do Ollama não é uma pasta de nomes de modelos legíveis que deva reorganizar manualmente; os manifestos remetem para blobs de conteúdo dentro dessa disposição.

# Exemplos de destinos — escolha um caminho real na sua máquina
/Volumes/AI-Library/Ollama/models       # macOS
/mnt/ai-library/ollama/models           # Linux
D:\AI-Library\Ollama\models             # Windows

Utilize a ferramenta de cópia normal da plataforma e compare depois o número de ficheiros ou os hashes. Não aponte o serviço para um destino parcialmente copiado enquanto a cópia ainda o está a alterar.

Defina OLLAMA_MODELS onde o processo Ollama consiga lê-la

A variável tem de existir no ambiente da aplicação ou do serviço Ollama, não apenas numa janela do terminal que fechará depois.

• Aplicação macOS: saia do Ollama, execute launchctl setenv OLLAMA_MODELS "/Volumes/AI-Library/Ollama/models" e volte a abrir a aplicação. A FAQ oficial indica que a aplicação herda as variáveis de ambiente através de launchctl.
• Serviço systemd no Linux: execute systemctl edit ollama.service, adicione Environment="OLLAMA_MODELS=/mnt/ai-library/ollama/models" em [Service], recarregue depois o systemd e reinicie o Ollama.
• Aplicação Windows: saia do Ollama através da barra de tarefas, adicione nas Definições do Windows uma variável de ambiente do utilizador chamada OLLAMA_MODELS e volte a iniciar a aplicação.

No Linux, o instalador padrão executa o serviço como o utilizador ollama. Por isso, as instruções oficiais exigem que esse utilizador tenha acesso de leitura e escrita ao destino; o respetivo exemplo é sudo chown -R ollama:ollama <directory>. Escolha permissões adequadas ao seu sistema em vez de permitir escrita na biblioteca a todos os utilizadores.

Verifique o destino em vez de confiar na definição

1. Reinicie completamente o Ollama.
2. Execute ollama list e confirme que um modelo conhecido está presente.
3. Execute esse modelo com um prompt pequeno e depois pare-o normalmente.
4. Obtenha um modelo pequeno ou inspecione a atividade de modificação para confirmar que os novos dados chegam ao destino.
5. Reinicie mais uma vez e repita o teste do modelo conhecido.

Se a lista estiver inesperadamente vazia, pare. Volte a verificar a variável tal como é vista pelo serviço, a propriedade do diretório e se copiou o conteúdo para dentro de uma pasta models adicional. Restaurar o valor de ambiente anterior deverá repor imediatamente o caminho antigo em serviço.

Mover o armazenamento não é o mesmo que preservá-lo

Um novo diretório pode resolver um problema de capacidade ou localização, mas continua a ser armazenamento de execução ativo. A eliminação acidental, uma falha do sistema de ficheiros ou uma limpeza excessiva podem afetar a única cópia. Mantenha uma estratégia de recuperação separada para modelos que não possa voltar a obter, recriar ou treinar.

O Tensor Archive é útil depois de conseguir identificar os ficheiros relacionados que pretende conservar. Arquive uma família local concluída, verifique-a e restaure-a num local separado antes de considerar dispensável qualquer cópia de trabalho. Não substitui OLLAMA_MODELS, não edita o serviço nem finge que uma alteração de caminho é uma cópia de segurança.

O que ler a seguir

Para consultar as predefinições e o comportamento das substituições, veja onde o Ollama armazena os modelos. Se várias ferramentas apontarem agora para o mesmo disco, utilize a lista de verificação para conservação da biblioteca local de modelos antes de remover cópias antigas.