Installer BamBuddy sur ZimaOS avec Docker Compose

BamBuddy fonctionne sur ZimaOS via Docker Compose, même s’il ne s’agit pas d’un paquet intégré à l’App Store. Utilisez l’image précompilée en amont, rendez persistants ses dossiers /app/data et /app/logs, et conservez le réseau de l’hôte Linux si vous souhaitez la détection automatique des imprimantes Bambu.

Le fil de discussion d’origine ne proposait aucune solution, mais BamBuddy publie désormais un flux de travail Docker maintenu. ZimaOS prend en charge les applications Compose personnalisées : il n’est donc pas nécessaire de modifier le système d’exploitation hôte ni de compiler BamBuddy à partir des sources, sauf si vous souhaitez le développer.

Utiliser l’image Docker en amont

Le guide Docker actuel de BamBuddy recommande Docker comme méthode de déploiement la plus simple.

Paramètres Compose essentiels pour ZimaOS

services:
  bambuddy:
    image: ghcr.io/maziggy/bambuddy:latest
    container_name: bambuddy
    restart: unless-stopped
    network_mode: host
    environment:
      - TZ=YOUR_TIMEZONE
      - PUID=1000
      - PGID=1000
    volumes:
      - /DATA/AppData/bambuddy/data:/app/data
      - /DATA/AppData/bambuddy/logs:/app/logs

Ouvrez http://ZIMA-IP:8000 après le démarrage.

Pourquoi le réseau de l’hôte est important

BamBuddy utilise la détection sur le réseau local pour trouver les imprimantes Bambu. Son fichier Compose en amont utilise network_mode: host sous Linux, car le réseau pont classique ne reçoit pas le trafic de découverte SSDP attendu avec la même fiabilité.

Vous pouvez ajouter l’imprimante manuellement

Si la détection ne trouve pas l’imprimante, ajoutez-la à l’aide de son adresse IP sur le réseau local. Vérifiez que l’imprimante et ZimaOS sont connectés à des réseaux capables de communiquer entre eux et que le mode local/développeur requis de l’imprimante est activé.

Conserver les données avant toute mise à jour

BamBuddy stocke sa base de données, ses archives et ses données opérationnelles dans le répertoire de données configuré. Conservez ces chemins en dehors de la couche éphémère du conteneur.

Mettre à jour le déploiement Docker

docker compose pull
docker compose up -d

Le projet en amont a publié des mises à jour liées à la sécurité. Maintenez donc l’image à jour et effectuez une sauvegarde de l’application avant toute modification majeure.

Ne pas exposer directement le port 8000 à Internet

Conservez BamBuddy sur le réseau local ou derrière un accès HTTPS authentifié et privé à distance. Les interfaces de gestion des imprimantes ne doivent pas être exposées par une redirection de port sans précautions.

Le guide Docker personnalisé présente le modèle général des applications personnalisées.

Vérifier le conteneur avant d’ajouter une imprimante

docker ps | grep bambuddy
docker logs --tail 100 bambuddy

Vérifiez que le service web démarre correctement sur le port 8000 avant de chercher la cause d’un problème de détection de l’imprimante. Si le tableau de bord lui-même ne s’ouvre pas, le réseau de l’imprimante n’est pas encore en cause.

Sauvegarder la base de données de BamBuddy avant les mises à jour

Le projet en amont inclut sa propre fonction de sauvegarde. Utilisez-la avant toute modification majeure de l’image et conservez également une copie du répertoire de données persistant. Une image de conteneur peut toujours être téléchargée à nouveau ; votre historique d’impression et votre base de données locale, eux, ne le peuvent pas.

Le réseau de l’hôte étend la portée réseau du conteneur

Comme le mode hôte partage l’espace de noms réseau de ZimaOS, vérifiez les ports de l’application et maintenez le logiciel à jour. Le mode hôte est justifié ici par la détection de l’imprimante, mais il offre une isolation réseau moindre qu’un réseau pont classique.

Utiliser une adresse IP stable pour l’imprimante

Réservez si possible l’adresse IP de l’imprimante dans votre routeur. Même si la détection automatique fonctionne aujourd’hui, une adresse stable facilite grandement le dépannage de la caméra, de MQTT et des reconnexions manuelles après le redémarrage du routeur ou de l’imprimante.

FAQ

BamBuddy est-il disponible dans l’App Store de ZimaOS ?

L’utilisateur à l’origine de la question n’a pas trouvé de paquet dédié ; Docker Compose personnalisé est la solution la plus simple.

Quel port BamBuddy utilise-t-il ?

L’interface web utilise par défaut le port 8000.

Pourquoi utiliser le réseau de l’hôte ?

Il permet la détection depuis le conteneur Linux et les fonctions réseau liées aux imprimantes attendues par BamBuddy.

Puis-je le compiler à partir des sources ?

Oui, mais le projet en amont recommande l’image précompilée pour les déploiements courants.