Community-Lösung

ZimaOS-Update wird nicht angezeigt: Automatisches Update, Netzwerkprüfungen und Befehlszeilen-Alternative

An October 2025 thread where several ZimaOS 1.4.3 users did not receive the 1.5 update prompt. Community troubleshooting checked DNS and network filtering; one user could not download the release at first but later updated successfully with the official OTA command-line updater.

Wenn eine neue ZimaOS-Version verfügbar ist, Ihr Server aber weiterhin die alte Version anzeigt, bedeutet die fehlende Schaltfläche nicht automatisch, dass die Installation defekt ist. Im ursprünglichen Thread vom Oktober 2025 ging es um Nutzer, die bei Version 1.4.3 festsaßen und auf Version 1.5 warteten. Die Diskussion umfasste DNS-Filterung, Internetzugriff, Fehler beim direkten Download und schließlich das offizielle OTA-Update über die Befehlszeile.

Version 1.5 ist inzwischen historisch, aber die Logik zur Fehlerbehebung bleibt nützlich: Das automatische Update ist der empfohlene Weg, Netzwerkfilter können den Download von Update-Metadaten oder Paketen verhindern, und IceWhale stellt für Fälle, in denen der normale Update-Ablauf fehlschlägt, eine Befehlszeilen-Alternative bereit.

Das automatische Upgrade ist die empfohlene Methode

IceWhales offizielle Installations- und Upgrade-Anleitung beschreibt das automatische Upgrade als einfachste und sicherste Methode. ZimaOS lädt das Paket im Hintergrund herunter und zeigt in den Einstellungen eine Benachrichtigung an, sobald das Update bereit ist.

Das bedeutet, dass Nutzer nicht unbedingt sofort eine Upgrade-Schaltfläche sehen, sobald eine neue Version angekündigt wird.

Prüfen Sie die Verbindung, bevor Sie von einem Defekt des OTA-Systems ausgehen

Im ursprünglichen Thread fragten Mitglieder der Community, ob Pi-hole, AdGuard Home, NextDNS, Firewall-Regeln oder benutzerdefinierte DNS-Einstellungen den Update-Dienst blockieren könnten. Ein Nutzer entfernte die benutzerdefinierten DNS-Einstellungen und testete sogar eine DMZ-Konfiguration – ohne Erfolg.

Diese erfolglosen Tests sind hilfreich, weil sie zeigen, dass „DNS prüfen“ lediglich ein Diagnosezweig und keine garantierte Lösung ist.

Ein Nutzer konnte die Version auch außerhalb der Benutzeroberfläche nicht herunterladen

Ein späterer Teilnehmer probierte den Updater über die Befehlszeile aus und erhielt einen Download-Fehler. Außerdem versuchte er, die Version direkt von der GitHub-Veröffentlichungsseite von IceWhale herunterzuladen, und beobachtete extrem langsame Übertragungen.

Diese Hinweise deuteten eher auf ein Problem mit der Verbindung oder dem Bereitstellungsweg hin als nur auf eine fehlende Schaltfläche in den Einstellungen.

IceWhale bietet einen offiziellen Upgrade-Weg über die Befehlszeile

Die offizielle Upgrade-Anleitung für Zima-Giorgio dokumentiert diese Alternative für Fälle, in denen das automatische Upgrade fehlschlägt:

sudo -i
curl -fsSL 'https://ota.zimaos.com/' | sh

Wenn keine Version angegeben wird, wählt das Skript die neueste Version entsprechend dem aktuellen Update-Kanal aus. IceWhale dokumentiert außerdem versionsspezifische URLs für gezielte Upgrades oder Downgrades.

Lesen Sie die offizielle Installations- und Upgrade-Anleitung für ZimaOS, bevor Sie ein Update anhand eines historischen Forenbeitrags erzwingen.

Der Nutzer aus dem ursprünglichen Thread aktualisierte schließlich mit dem OTA-Skript

Am 25. Oktober meldete sich der Teilnehmer, der die Version nicht herunterladen konnte, zurück und teilte mit, dass der allgemeine OTA-Befehl sein System erfolgreich auf ZimaOS 1.5 aktualisiert hatte.

Das ist ein bestätigtes Ergebnis aus der Quelle. Es beweist jedoch nicht, warum die grafische Benachrichtigung nicht angezeigt wurde.

Der Beta-Kanal dient zum Testen und ist keine Lösung für jedes fehlende stabile Update

Im Entwicklermodus kann ZimaOS auf den Beta-Update-Kanal umgestellt werden. Das ist sinnvoll, wenn Sie bewusst Vorabversionen verwenden möchten. Er sollte nicht lediglich deshalb aktiviert werden, weil die Bereitstellung einer stabilen Version scheinbar langsam erfolgt.

Die offizielle Anleitung empfiehlt weiterhin das automatische stabile Upgrade als Standardeinstellung.

Behandeln Sie Skripte für Remote-Updates als privilegierte Systemvorgänge

Der OTA-Befehl lädt ein Skript herunter und führt es als Root aus. Verwenden Sie ausschließlich die offizielle OTA-Domain von IceWhale, stellen Sie sicher, dass der Server über eine stabile Stromversorgung und Netzwerkverbindung verfügt, und sichern Sie wichtige Daten, bevor Sie einen Versionswechsel erzwingen.

Erzwingen Sie auf einem aktuellen Server nicht die historische URL für Version 1.5.0

Im ursprünglichen Thread ging es ausdrücklich um den Wechsel von 1.4.3 auf 1.5 im Oktober 2025. Das aktuelle ZimaOS ist dieser Version inzwischen weit voraus. Ein versionsgebundener Befehl für 1.5 gehört in den historischen Kontext und ist keine Empfehlung für ein aktuelles Upgrade.

FAQ zu ZimaOS-Updates

Muss jede neue Version sofort auf jedem Server erscheinen?

Nicht unbedingt. Der Zeitpunkt der automatischen Bereitstellung und des Paketdownloads kann von der öffentlichen Ankündigung abweichen.

Können DNS-Filter Updates blockieren?

Sie können Update-Endpunkte beeinträchtigen und sind daher eine sinnvolle Prüfmöglichkeit. Die Nutzer aus dem ursprünglichen Thread konnten ihr Problem jedoch nicht einfach durch eine Änderung der DNS-Einstellungen lösen.

Gibt es einen offiziellen Updater für die Befehlszeile?

Ja. IceWhales offizielle Upgrade-Anleitung dokumentiert das OTA-Skript als Alternative, wenn das automatische Upgrade fehlschlägt.