9. Sauvegardes et maintenance
9.1 Sauvegardes automatiques
Marvin OS sauvegarde automatiquement sa base de données chaque nuit à minuit. Les 5 dernières sauvegardes sont conservées, la plus ancienne est supprimée automatiquement quand la limite est atteinte.
- Les sauvegardes sont stockées dans /volume1/docker/marvin/backups/ sur votre NAS.
- Format du nom : marvin_YYYY-MM-DD_HHMMSS.db
- Vous pouvez également créer une sauvegarde manuelle à tout moment via le bouton CRÉER.
9.2 Restaurer une sauvegarde
En cas de problème, la restauration se fait en un clic depuis le dashboard :
- Allez dans Config Serveur → Sauvegarde & Restauration
- Cliquez sur Restaurer en face de la sauvegarde souhaitée
- Confirmez l’opération — Marvin redémarre automatiquement
- Le dashboard se reconnecte automatiquement après le redémarrage
⚠️ La restauration remplace toutes les données actuelles
Pensez à créer une sauvegarde manuelle avant toute restauration si vous souhaitez conserver l'état actuel de la base de données.
9.3 Redémarrer le bot
Le bouton REBOOT dans la section Sauvegarde & Restauration permet de redémarrer Marvin OS sans passer par Portainer. Utile après une modification de configuration qui nécessite un redémarrage.
Le dashboard affiche un indicateur de redémarrage en cours et se reconnecte automatiquement une fois le bot de nouveau opérationnel.
9.4 Mettre à jour le bot
Pour mettre à jour Marvin OS avec une nouvelle version :
- Créez une sauvegarde manuelle depuis le dashboard
- Téléchargez le nouveau fichier bot.py depuis egamaker.be
- Remplacez l’ancien fichier bot.py dans /volume1/docker/marvin/ via File Station
- Dans Portainer → Stacks → marvin → Editor, cliquez sur Update the stack
- Ne cochez PAS Re-pull image and redeploy (inutile et plus lent)
- Vérifiez les logs du conteneur pour confirmer le démarrage
💡 Vos données sont préservées lors des mises à jour
Le fichier marvin.db et toutes vos sauvegardes sont sur votre NAS et non dans le conteneur. Remplacer bot.py ne touche jamais à vos données.
9.5 En cas de problème
| Symptôme | Solution |
| Le dashboard ne répond pas | Vérifiez que le conteneur est bien Running dans Portainer. Consultez les logs. |
| ModuleNotFoundError au démarrage | Vérifiez que requirements.txt est complet et relancez le stack. |
| Le bot ne répond pas sur Discord | Vérifiez le DISCORD_TOKEN dans .env. Vérifiez les Privileged Intents sur le portail Discord. |
| Les rôles XP ne s’attribuent pas | Vérifiez que le rôle de Marvin est bien au-dessus des rôles XP dans la hiérarchie Discord. |
| L’avatar ne se met pas à jour | Limite Discord : maximum 2 changements par heure. Attendez et réessayez. |
| Email non envoyé | Vérifiez le mot de passe d’application Google. Testez avec le bouton Tester l’envoi du dashboard. |
Marvin OS est maintenant pleinement opérationnel sur votre serveur. Si ce guide vous a été utile, n’hésitez pas à soutenir le projet sur egamaker.be — chaque coup de pouce compte pour continuer à développer de nouveaux outils pour la communauté maker. Bonne bidouille !
"Voilà. Mon cerveau de la taille d'une planète vient de vous guider à travers l'intégralité de cette installation. J'espère que vous en êtes reconnaissants. Pas de panique."
Marvin OS est entièrement gratuit
Le code source du bot, le dashboard et ce guide en 9 parties sont mis à disposition gratuitement pour toute la communauté maker et Discord.
Si ce projet vous fait gagner du temps ou vous évite des heures de développement, vous pouvez offrir un café à l’auteur. Ce n’est pas une obligation — juste une façon sympa de dire merci et d’encourager la création de nouveaux projets open source.
☕ Chaque café compte et motive à continuer !
