Solution communautaire

Mise à jour de ZimaOS introuvable : mise à jour automatique, vérifications réseau et solution de repli en ligne de commande

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.

Lorsqu’une nouvelle version de ZimaOS est disponible, mais que votre serveur affiche toujours l’ancienne version, l’absence du bouton ne signifie pas automatiquement que l’installation est défectueuse. Le fil de discussion d’octobre 2025 concernait des utilisateurs bloqués en version 1.4.3 dans l’attente de la 1.5. La discussion a porté sur le filtrage DNS, l’accès à Internet, les échecs de téléchargement direct, puis finalement sur le programme de mise à jour OTA officiel en ligne de commande.

La version 1.5 appartient désormais au passé, mais la logique de dépannage reste utile : la mise à jour automatique est la méthode recommandée, le filtrage réseau peut empêcher le téléchargement des métadonnées ou des paquets de mise à jour, et IceWhale fournit une solution de secours en ligne de commande lorsque la procédure de mise à jour normale échoue.

La mise à niveau automatique est la méthode recommandée

Le tutoriel officiel d’installation et de mise à niveau d’IceWhale décrit la mise à niveau automatique comme la méthode la plus simple et la plus sûre. ZimaOS télécharge le paquet en arrière-plan et affiche une notification dans les paramètres une fois la mise à jour prête.

Cela signifie que les utilisateurs ne voient pas nécessairement un bouton de mise à niveau dès qu’une annonce de nouvelle version est publiée.

Vérifiez la connectivité avant de conclure que le système OTA est défaillant

Dans le fil de discussion d’origine, des membres de la communauté ont demandé si Pi-hole, AdGuard Home, NextDNS, des règles de pare-feu ou un DNS personnalisé pouvaient bloquer le service de mise à jour. Un utilisateur a supprimé son DNS personnalisé et a même testé une configuration en DMZ, sans succès.

Ces tests négatifs sont utiles, car ils montrent que « vérifier le DNS » constitue une piste de diagnostic, et non une solution garantie.

Un utilisateur ne pouvait pas télécharger la version, même en dehors de l’interface

Un autre participant a ensuite essayé le programme de mise à jour en ligne de commande et a obtenu un échec de téléchargement. Il a également tenté de télécharger directement la version depuis la page des versions publiées sur GitHub d’IceWhale et a constaté un transfert extrêmement lent.

Ces éléments orientaient davantage vers un problème de connectivité ou de distribution que vers la seule absence d’un bouton dans les paramètres.

IceWhale fournit une procédure officielle de mise à niveau en ligne de commande

Le tutoriel officiel de mise à niveau de Zima-Giorgio documente désormais cette solution de secours lorsque la mise à niveau automatique échoue :

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

Lorsqu’aucune version n’est spécifiée, le script sélectionne la dernière version disponible selon le canal de mise à jour actuel. IceWhale documente également des URL propres à chaque version pour effectuer volontairement une mise à niveau ou une rétrogradation.

Consultez la procédure officielle d’installation et de mise à niveau de ZimaOS avant de forcer une mise à jour à partir d’un extrait de forum ancien.

L’utilisateur du fil d’origine a finalement effectué la mise à jour avec le script OTA

Le 25 octobre, le participant qui ne parvenait pas à télécharger la version est revenu indiquer que la commande OTA générique avait bien mis son système à niveau vers ZimaOS 1.5.

Il s’agit d’un résultat confirmé par la source. Cela ne permet toutefois pas de déterminer pourquoi la notification graphique ne s’était pas affichée.

Le canal bêta sert aux tests, pas à résoudre toute absence de mise à jour stable

Le mode développeur permet de basculer ZimaOS vers le canal de mise à jour bêta. Cette option est utile si vous souhaitez volontairement utiliser des versions préliminaires. Elle ne doit pas être activée simplement parce que le déploiement d’une version stable semble lent.

Le tutoriel officiel recommande toujours la mise à niveau automatique stable comme option par défaut.

Traitez les scripts de mise à jour à distance comme des opérations système privilégiées

La commande OTA télécharge et exécute un script en tant que superutilisateur. Utilisez uniquement le domaine OTA officiel d’IceWhale, vérifiez que le serveur dispose d’une alimentation et d’une connexion réseau stables, et sauvegardez les données importantes avant de forcer un changement de version.

Ne forcez pas l’URL historique de la version 1.5.0 sur un serveur actuel

Le fil de discussion d’origine portait précisément sur le passage de la version 1.4.3 à la version 1.5 en octobre 2025. La version actuelle de ZimaOS a depuis largement évolué. Une commande ciblant précisément la version 1.5 appartient au contexte historique et ne constitue pas une recommandation de mise à niveau actuelle.

FAQ sur les mises à jour de ZimaOS

Chaque nouvelle version doit-elle apparaître immédiatement sur tous les serveurs ?

Pas nécessairement. Le délai de distribution automatique et de téléchargement des paquets peut différer de celui de l’annonce publique.

Le filtrage DNS peut-il bloquer les mises à jour ?

Il peut perturber les points de terminaison de mise à jour, c’est donc une vérification pertinente. Toutefois, les utilisateurs du fil d’origine n’ont pas résolu leur problème en modifiant simplement le DNS.

Existe-t-il un programme de mise à jour officiel en ligne de commande ?

Oui. Le tutoriel officiel de mise à niveau d’IceWhale documente le script OTA comme solution de secours lorsque la mise à niveau automatique échoue.