Ollama-Versionsupgrade und -migration
Wie man Ollama sicher aktualisiert, die Modellbibliothek auf eine neue Festplatte oder einen neuen Rechner verschiebt und benutzerdefinierte Modelle sichert und wiederherstellt.
Wenn du diese drei Dinge gut erledigst, gehören deine lokalen Modell-Assets wirklich dir – immun gegen jegliche Hardware- oder Versionsänderungen.
Sicheres Upgrade: Strategie vor der Aktion
Das Upgrade selbst ist einfach; der schwierige Teil ist, "nichts falsch zu machen". Empfohlene dreistufige Upgrade-Strategie:
Schritt 1: Prüfe die Release Notes: Die Release Notes heben neue Funktionen, Fehlerbehebungen und bekannte Probleme hervor, insbesondere Modellunterstützung und Schnittstellenänderungen.
Schritt 2: Kritische Assets sichern: Exportieren Sie die verwendeten benutzerdefinierten Modellrezepte (siehe Methode unten) und überprüfen Sie den Speicherort des Modellverzeichnisses.
Schritt 3: Vor dem Rollout testen: Verifizieren Sie das Upgrade bei Produktionsservern zuerst auf einer Testmaschine und rollen Sie es dann in größerem Umfang aus.
| Plattform | Aktualisierungsmethode |
|---|---|
| macOS / Windows | Updates automatisch herunterladen: Klicken Sie in der Menüleiste oder im System-Tray auf „Zum Aktualisieren neu starten“ |
| Linux (Skriptinstallation) | Führen Sie das offizielle Installationsskript erneut aus |
| Linux (manuelle Installation) | Löschen Sie zuerst das alte Bibliotheksverzeichnis und entpacken Sie dann das neue Paket |
| Docker | Nach dem Pull des neuen Images erstellen Sie den Container neu; das Daten-Volume behält alle Modelle |
Wenn Sie auf Kompatibilitätsprobleme stoßen und ein Rollback durchführen müssen oder die Pre-Release-Version ausprobieren möchten, verwenden Sie die Versionsnummernvariable für eine präzise Steuerung und installieren Sie die angegebene Version (siehe Versionsnummern in den GitHub Releases):
curl -fsSL https://ollama.com/install.sh | OLLAMA_VERSION=0.5.7 sh
Pre-Release-Versionen werden ebenfalls über Versionsnummern installiert.
Löschen Sie vor dem manuellen Upgrade unter Linux zuerst das alte Bibliotheksverzeichnis (sudo rm -rf /usr/lib/ollama); das Mischen alter und neuer Inferenzbibliotheken ist die Ursache Nummer eins für „seltsames Verhalten nach dem Upgrade“.
Migration der Modellbibliothek: Festplatten- und Maschinenwechsel
Modelle sind oft zig GB groß; das Wesentliche an der Migration ist nur ein Satz: Verschieben Sie das Modellverzeichnis und teilen Sie Ollama dann den neuen Speicherort mit.
Szenario 1: Austausch der Festplatte auf derselben Maschine
Beispiel
sudo mv /usr/share/ollama/.ollama/models /data/ollama-models
# 2. Verweisen Sie die Umgebungsvariable auf den neuen Speicherort (siehe Konfigurationskapitel für drei Methoden zur Plattformeinrichtung)
OLLAMA_MODELS=/data/ollama-models ollama serve
# 3. Bei einer Standard-Linux-Installation muss der Besitz auf den Benutzer ollama übertragen werden
sudo chown -R ollama:ollama /data/ollama-models
Szenario 2: Migration auf einen neuen Rechner
Beispiel
tar czf models-backup.tar.gz -C ~/.ollama models
# Neuer Rechner: dieselbe Version von Ollama installieren, dann an den entsprechenden Speicherort entpacken
mkdir -p ~/.ollama
tar xzf models-backup.tar.gz -C ~/.ollama
# Überprüfen, ob die Modellliste vollständig ist
ollama list
Zwei Details entscheiden über den Erfolg oder Misserfolg der Migration: Die Ollama-Version auf dem neuen Rechner sollte möglichst mit der auf dem alten Rechner übereinstimmen; die Struktur der blobs und manifests unter dem models-Verzeichnis muss unverändert beibehalten werden; kopieren Sie nicht nur einzelne Modelldateien.
Sicherung und Wiederherstellung benutzerdefinierter Modelle
Benutzerdefinierte Modelle (Produkte, die aus Modelfile erstellt wurden) haben zwei Backup-Methoden; es wird empfohlen, beide durchzuführen.
Methode 1: Rezept nach Git exportieren
Beispiel
ollama show --modelfile example-coder > example-coder.modelfile
Beachten Sie ein Detail: Die FROM-Zeile im exportierten Rezept verweist auf den lokalen Blob-Dateipfad, daher kann sie nach einem Rechnerwechsel nicht direkt verwendet werden. Ändern Sie beim Wiederherstellen FROM zurück in den Basismodellnamen (z. B. FROM qwen3.5:9b) und erstellen Sie es neu.
Beispiel
ollama create example-coder -f example-coder.modelfile
Methode 2: Push in die Modellbibliothek für Cloud-Backup
Beispiel
ollama cp example-coder myteam/example-coder:v1
ollama push myteam/example-coder:v1
Empfohlene Organisation: Alle Modelfiles in ein Git-Repository zur Verwaltung legen, kombiniert mit einem Skript zum Neuaufbau der Umgebung von Grund auf – Hardware wird ersetzt, Systeme werden neu installiert, aber mit den Rezepten zur Hand können alle benutzerdefinierten Modelle in zehn Minuten wiederhergestellt werden.
Andere Erweiterungen