Ollama : atualizar, remover um modelo, desinstalar

#Por que fazer a manutenção do Ollama

O Ollama evolui no ritmo do mecanismo llama.cpp que incorpora: cada atualização traz suporte a novos modelos, ganhos de velocidade, correções para GPU e, às vezes, mudanças de formato. Permanecer em uma versão antiga é se privar de modelos recentes (« this model is not supported by your version of Ollama ») e continuar convivendo com bugs já corrigidos.

A outra metade da manutenção é o disco. Um modelo de 7B em Q4_K_M ocupa cerca de 4 a 5 GB, um de 14B em torno de 9 GB, um de 32B perto de 20 GB. Teste cerca de dez modelos ao longo de algumas semanas e você terá preenchido facilmente 100 GB sem perceber. Saber excluir corretamente e verificar o espaço realmente ocupado faz parte do trabalho.

#Verificar a versão

Antes de tudo, confira qual versão você está usando. O comando funciona da mesma forma nos três sistemas e fornece o número da versão instalada.

ollama --version
# ollama version is 0.x.y

Compare esse número com a versão mais recente publicada na página oficial de lançamentos (github.com/ollama/ollama/releases). Se a sua versão estiver várias versões atrás da atual, a atualização abaixo leva dois minutos.

#Atualizar Ollama (Windows, macOS, Linux)

A atualização nunca afeta seus modelos: o diretório ~/.ollama é independente do binário. Assim, você pode atualizar o aplicativo sem precisar baixar nada novamente. O método depende apenas do seu sistema.

1. 01
   Windows

   O aplicativo verifica automaticamente as atualizações e exibe uma notificação quando uma nova versão está pronta; basta clicar para instalá-la. Para forçar a atualização, baixe novamente o instalador OllamaSetup.exe de ollama.com/download e execute-o sobre a instalação existente: seus modelos serão preservados.
2. 02
   macOS

   Mesma lógica: o aplicativo oferece a atualização na barra de menus (ícone Ollama → “Restart to update”). Caso contrário, baixe novamente o .dmg de ollama.com/download e substitua o aplicativo em /Applications. Se você o instalou via Homebrew, execute “brew upgrade ollama” em vez disso.
3. 03
   Linux

   Basta executar novamente o script de instalação oficial: ele detecta a instalação existente e substitui o binário pela versão mais recente, sem apagar seus modelos nem seu serviço systemd.

# Réexécuter le script officiel met à jour le binaire en place
curl -fsSL https://ollama.com/install.sh | sh

# Vérifier, puis redémarrer le service si besoin
ollama --version
sudo systemctl restart ollama

#Excluir um modelo: ollama rm

Para limpar o ambiente, comece listando exatamente o que você realmente instalou. A coluna SIZE mostra o tamanho aparente de cada modelo, e TAG o nome exato a passar na remoção.

# Voir tous les modèles installés, avec leur taille
ollama list

# Supprimer un modèle précis (nom:tag exact)
ollama rm llama3.1:8b

# Supprimer plusieurs modèles d'un coup
ollama rm gemma3:12b qwen2.5:7b

Atenção à tag: « llama3.1 » e « llama3.1:8b » podem designar entradas diferentes. Copie o nome exato exibido por ollama list para não remover nada além do que você deseja. Um modelo em uso por uma requisição será liberado no final dessa requisição.

#A realidade dos blobs compartilhados

Ollama não armazena um arquivo monolítico por modelo. Internamente, cada modelo é descrito por um manifesto que referencia vários blobs: os pesos (o grande arquivo GGUF), mas também o template de prompt, os parâmetros e a licença. Esses blobs são identificados por seu hash SHA-256 e deduplicados: dois modelos que compartilham exatamente o mesmo arquivo de pesos armazenam apenas uma cópia.

Concretamente, se você tirou « llama3.1:8b » e « llama3.1:8b-instruct-q4_K_M » que apontam para o mesmo blob de pesos, excluir um dos dois não libera nada do lado dos pesos: o outro ainda referencia o blob. Ao contrário, excluir o último modelo que referenciava um blob o remove finalmente do disco. É por isso que o espaço recuperado por um ollama rm est às vezes é bem inferior ao tamanho anunciado pelo ollama list.

Manifesto

Um pequeno arquivo JSON por modelo:tag, em ~/.ollama/models/manifests/. É ele que ollama rm supprime primeiro.

Blob

Um arquivo de dados (pesos, template, parâmetros) chamado sha256-<hash>, em ~/.ollama/models/blobs/. Compartilhado entre todos os modelos que o referenciam.

Deduplicação

Um blob só é apagado quando nenhum manifesto faz mais referência a ele. Isso é bom: evita duplicar gigabytes idênticos.

#Localizar e limpar o espaço em disco

Para saber realmente o que ocupa seu disco, verifique o tamanho da pasta de armazenamento, e não apenas a saída do ollama list — essa última soma tamanhos que podem compartilhar blobs.

# Taille totale réellement occupée sur le disque
du -sh ~/.ollama/models

# Détail : blobs (les poids) vs manifests (les métadonnées)
du -sh ~/.ollama/models/blobs ~/.ollama/models/manifests

# Les plus gros blobs en premier
ls -lhS ~/.ollama/models/blobs/ | head

# Taille totale du dossier de modèles
Get-ChildItem "$env:USERPROFILE\.ollama\models" -Recurse |
  Measure-Object -Property Length -Sum |
  Select-Object @{n='Go';e={[math]::Round($_.Sum/1GB,2)}}

A rotina de limpeza mais eficaz: listar, identificar os modelos que você não usa mais, removê-los com ollama rm e depois medir novamente com du -sh para verificar o espaço recuperado. Como a deduplicação influencia o resultado, remova as variantes redundantes de um mesmo modelo por último — é nesse momento que o espaço realmente é liberado.

#Desinstalar completamente o Ollama

A desinstalação é feita em dois passos: remover a aplicação e, depois, apagar os arquivos restantes (modelos e configuração), se você quiser realmente limpar tudo. O segundo passo é o mesmo, independentemente do sistema operacional — é a pasta ~/.ollama que deve ser excluída.

1. 01
   Windows

   Acesse Configurações → Aplicativos → Aplicativos instalados, procure « Ollama » e clique em Desinstalar. Em seguida, remova a pasta C:\Users\<você>\.ollama para apagar os modelos baixados.
2. 02
   macOS

   Arraste Ollama.app de /Applications para a lixeira. Em seguida, exclua ~/.ollama para remover os modelos. Se você havia instalado via Homebrew: « brew uninstall ollama ».
3. 03
   Linux

   Pare e desative o serviço, remova o binário e o arquivo systemd, exclua o usuário do sistema «ollama» criado pelo script, depois apague a pasta dos modelos.

# 1. Arrêter et désactiver le service
sudo systemctl stop ollama
sudo systemctl disable ollama
sudo rm /etc/systemd/system/ollama.service

# 2. Retirer le binaire (souvent dans /usr/local/bin ou /usr/bin)
sudo rm $(which ollama)

# 3. Supprimer l'utilisateur et le groupe système créés par le script
sudo userdel ollama
sudo groupdel ollama

# 4. Effacer les modèles et la configuration
rm -rf ~/.ollama
sudo rm -rf /usr/share/ollama/.ollama

#Solução de problemas

« this model is not supported by your version »

A sua versão do Ollama é antiga demais para o formato do modelo. Atualize-a (seção acima) e execute novamente ollama pull.

ollama rm ne libère presque rien

O blob de pesos ainda é referenciado por outra variante do modelo. Liste as variantes com ollama list e remova também as redundantes.

“Error: model is currently loaded”

Uma requisição ainda está usando o modelo. Aguarde sua conclusão ou reinicie o daemon (systemctl restart ollama / encerrar e reabrir o app) antes de excluir.

O disco permanece cheio após exclusão

Verifique a localização real dos modelos (variável OLLAMA_MODELS, ou /usr/share/ollama/.ollama no Linux com serviço) e meça novamente com du -sh.

O comando ollama não é encontrado após desinstalação parcial

O binário foi removido, mas o PATH ainda o referencia; abra um novo terminal ou verifique se não há nenhum link antigo em /usr/local/bin.

#Para se aprofundar

A manutenção resolve a questão de « como manter o Ollama limpo »; estes guias cobrem o antes e o depois — (re)instalar conforme seu sistema operacional, entender os comandos básicos e escolher os modelos que valem o espaço que ocupam.