Ollama actualización de versión y migración
Cómo actualizar Ollama de forma segura, trasladar la biblioteca de modelos a un nuevo disco o máquina nueva, y la copia de seguridad y restauración de modelos personalizados.
Si haces bien estas tres cosas, tus activos de modelos locales realmente te pertenecerán, sin temor a cambios de hardware o versiones.
Actualización segura: la estrategia antes que la operación
Actualizar en sí es sencillo, lo difícil es "no fallar". La estrategia de actualización recomendada en tres pasos:
Primer paso, leer las notas de la versión: en las Release Notes se indican nuevas funciones, correcciones y problemas conocidos, especialmente cambios en el soporte de modelos y en las interfaces.
Segundo paso, respaldar los activos clave: exportar las recetas de los modelos personalizados en uso (método más abajo) y confirmar la ubicación del directorio de modelos.
Tercer paso, probar antes de implementar: en el servidor de producción, primero verificar la actualización en una máquina de prueba y luego implementarla por completo.
| Plataforma | Método de actualización |
|---|---|
| macOS / Windows | Descarga automática de actualizaciones, haz clic en "Restart to update" en la barra de menú o en la bandeja |
| Linux (instalación mediante script) | Vuelve a ejecutar el script de instalación oficial |
| Linux (instalación manual) | Primero elimina el directorio de la biblioteca antigua y luego descomprime el nuevo paquete |
| Docker | Tras hacer pull de la nueva imagen, reconstruye el contenedor; el volumen de datos conserva todos los modelos |
Si encuentras problemas de compatibilidad y necesitas revertir, o quieres probar la versión preliminar, usa la variable de número de versión para controlar con precisión e instala la versión especificada (consulta los números de versión en GitHub Releases):
curl -fsSL https://ollama.com/install.sh | OLLAMA_VERSION=0.5.7 sh
Las versiones preliminares también se instalan mediante el número de versión.
Antes de la actualización manual en Linux, elimina primero el directorio de la biblioteca antigua (sudo rm -rf /usr/lib/ollama); mezclar bibliotecas de inferencia antiguas y nuevas es la causa principal de "comportamiento extraño después de actualizar".
Migración de la biblioteca de modelos: cambio de disco y cambio de máquina
Los modelos suelen ocupar decenas de GB; la esencia de la migración se resume en una frase: mover el directorio models y luego indicarle a Ollama dónde está la nueva ubicación.
Escenario 1: Cambio de disco en la misma máquina
Ejemplo
sudo mv /usr/share/ollama/.ollama/models /data/ollama-models
# 2. La variable de entorno apunta a la nueva ubicación (consulta el capítulo de configuración para el método de configuración en las tres plataformas)
OLLAMA_MODELS=/data/ollama-models ollama serve
# 3. En la instalación estándar de Linux, hay que transferir el propietario al usuario ollama
sudo chown -R ollama:ollama /data/ollama-models
Escenario 2: Migrar a una nueva máquina
Ejemplo
tar czf models-backup.tar.gz -C ~/.ollama models
# Máquina nueva: instala la misma versión de Ollama y descomprime en la ubicación correspondiente
mkdir -p ~/.ollama
tar xzf models-backup.tar.gz -C ~/.ollama
# Verifica que la lista de modelos esté completa
ollama list
Dos detalles deciden el éxito o fracaso de la migración: la versión de Ollama en la máquina nueva debe ser lo más similar posible a la de la máquina antigua; la estructura de blobs y manifests en el directorio models debe conservarse tal cual, no copies solo archivos de modelo individuales.
Copia de seguridad y restauración de modelos personalizados
Los modelos personalizados (producto construido con Modelfile) tienen dos métodos de copia de seguridad; se recomienda hacer ambos.
Método 1: Exportar la receta a Git
Ejemplo
ollama show --modelfile ejemplo-coder > ejemplo-coder.modelfile
Ten en cuenta un detalle: en la receta exportada, la línea FROM apunta a la ruta del archivo blob local y no se puede usar directamente después de cambiar de máquina. Al restaurar, cambia FROM de vuelta al nombre del modelo base (por ejemplo, FROM qwen3.5:9b) y reconstruye.
Ejemplo
ollama create ejemplo-coder -f ejemplo-coder.modelfile
Método 2: Enviar a la biblioteca de modelos para hacer una copia de seguridad en la nube
Ejemplo
ollama cp ejemplo-coder myteam/ejemplo-coder:v1
ollama push myteam/ejemplo-coder:v1
Forma de organización recomendada: guarda todos los Modelfile en un repositorio Git para gestionarlos, junto con un script para reconstruir el entorno desde cero: el hardware cambiará, el sistema se reinstalará, con la receta en mano, restaurarás todos los modelos personalizados en diez minutos.
Otras extensiones