Guardar copias de seguridad de modelos y datos de Ollama

Qué cubre este artículo sobre backups en Ollama

• Qué es necesario resguardar en una instalación de Ollama.
• Dónde almacena Ollama sus datos.
• Cómo exportar modelos y configuraciones.
• Cómo restaurar en un sistema nuevo.
• Estrategias para backups automáticos y portátiles.

Introducción: guardar copias de seguridad de modelos y datos de Ollama

Las instalaciones de Ollama contienen, además del programa en sí, modelos, Modelfiles y configuraciones. Sin una copia de seguridad, un fallo de hardware, la migración a una máquina nueva o un borrado accidental significa perder mucho trabajo. Hacer backups regularmente permite restaurar los modelos rápidamente o replicarlos idénticamente en otro sistema.

Este artículo muestra qué datos son relevantes y cómo guardarlos de forma confiable.

Términos clave

• Directorio de modelos: ubicación donde Ollama almacena los modelos.
• Blob: archivo binario de gran tamaño que contiene un modelo.
• Manifest: metadatos de un modelo.
• Modelfile: archivo de descripción para un modelo personalizado.
• Volume: almacenamiento de datos de Docker para Ollama.
• Restore: restauración de una copia de seguridad.
• Export: guardar un modelo como archivo.

Dónde almacena Ollama los datos

Por defecto, los datos se encuentran en:

~/.ollama

En Linux, la ubicación real es:

/usr/share/ollama/.ollama/models

Con Docker, el directorio está en el volumen ollama-data bajo /root/.ollama.

Contenidos importantes

• models/blobs/: archivos binarios grandes de los modelos.
• models/manifests/: descripciones de los modelos.
• id_ed25519 e id_ed25519.pub: par de claves para la firma de modelos.

Qué debería respaldarse

Componente	Razón
~/.ollama	Contiene modelos, manifests y claves.
Modelfiles	Describen modelos personalizados.
Archivos Compose	Definen el servicio Ollama.
Archivos .env	Contienen configuración y secrets.
Docker Volumes	Datos persistentes en contenedores.

Backup manual

tar -czf ollama-backup-$(date +%Y%m%d).tar.gz ~/.ollama

Para Docker:

docker run --rm -v ollama-data:/data -v $(pwd):/backup alpine \
  tar -czf /backup/ollama-data.tar.gz -C /data .

Restore

tar -xzf ollama-backup-20260907.tar.gz -C ~/

Para Docker:

docker volume create ollama-data
docker run --rm -v ollama-data:/data -v $(pwd):/backup alpine \
  tar -xzf /backup/ollama-data.tar.gz -C /data

Exportar modelos

Puedes exportar modelos individuales:

ollama show llama3.1 --modelfile > llama31.Modelfile
ollama cp llama3.1 mein-llama31

El modelo se puede importar después en otro sistema:

ollama create mein-llama31 -f llama31.Modelfile

Script de backup automatizado

#!/bin/bash
set -e

BACKUP_DIR="/backup/ollama/$(date +%Y%m%d_%H%M%S)"
mkdir -p "$BACKUP_DIR"

# Datos de Ollama
tar -czf "$BACKUP_DIR/ollama-data.tar.gz" -C "$HOME" .ollama

# Modelfiles y configuración
rsync -av "$HOME/ollama-config/" "$BACKUP_DIR/ollama-config/"

# Docker Compose
rsync -av /opt/ollama-compose/ "$BACKUP_DIR/compose/"

echo "Backup creado: $BACKUP_DIR"

Cronjob:

0 4 * * * /usr/local/bin/backup-ollama.sh

Cifrado

Encripta backups con Restic:

restic -r /mnt/backup-repo backup ~/.ollama

O con tar y GPG:

tar -czf - ~/.ollama | gpg -c > ollama-backup.tar.gz.gpg

Almacenamiento externo

• NAS o disco externo.
• Cloud storage con rclone.
• Nodo remoto de Tailscale.
• Almacenamiento de objetos compatible con S3.

Transferir modelos a un nuevo host

1. Crear backup.
2. Copiar ~/.ollama al nuevo equipo.
3. Instalar Ollama.
4. Ejecutar ollama list para verificar que se reconozcan los modelos.
5. Probar con ollama run.

Respaldar Docker Volumes

docker run --rm -v ollama-data:/data -v $(pwd):/backup alpine tar -czf /backup/ollama-data.tar.gz -C /data .

En el nuevo sistema:

docker volume create ollama-data
docker run --rm -v ollama-data:/data -v $(pwd):/backup alpine tar -xzf /backup/ollama-data.tar.gz -C /data

Consideraciones importantes

• Los modelos son archivos de gran tamaño, el backup requiere mucho espacio.
• Los backups incrementales con rsync o restic ahorran espacio.
• Los Modelfiles y la configuración deben respaldarse conjuntamente.
• Siempre haz un backup antes de actualizaciones importantes.
• Prueba los restores regularmente.

Errores comunes

• Solo se guarda el nombre del modelo: faltan los blobs.
• Espacio insuficiente: el backup se interrumpe.
• Directorio incorrecto: los datos de Ollama están en otra ubicación.
• Volume de Docker olvidado: los datos están en el volumen, no en el contenedor.
• Sin cifrado: modelos privados sin protección.
• Restore no probado: el backup es inútil.

Enlaces y referencias adicionales

• BotServ.de Comandos de Ollama
• BotServ.de Ciclo de vida de modelos en Ollama
• BotServ.de Backup en Docker
• BotServ.de Volumes de Docker

FAQ: Backup de Ollama

¿Puedo simplemente copiar los modelos? Sí, el directorio ~/.ollama contiene todo lo importante.

¿Necesito el par de claves? Solo si quieres enviar o verificar modelos firmados.

¿Qué tamaño tiene un backup? El tamaño combinado de todos los modelos, a menudo varios cientos de GB.

¿Puedo mover modelos entre hosts? Sí, con tar o rsync. Los manifests y blobs deben ir juntos.

¿Debería cifrar los backups? Sí, especialmente si los modelos o configuraciones contienen información sensible.

Fuentes y referencias

• Directorio de datos de Ollama: https://github.com/ollama/ollama/blob/main/docs/faq.md
• rsync: https://rsync.samba.org/
• restic: https://restic.net/

Resumen: guardar copias de seguridad de modelos y datos de Ollama

Un backup de Ollama incluye principalmente el directorio ~/.ollama con modelos, manifests y claves. Las copias de seguridad manuales con tar o rsync son simples, y los scripts automatizados con backups cifrados externos protegen de forma confiable. Incluir Modelfiles, configuraciones de Compose y volumes permite restaurar rápidamente en caso de emergencia. Las pruebas regulares de restore garantizan que el backup funcione cuando sea necesario.