# Changer d'instance

**URL:** <https://community.gladysassistant.com/t/changer-dinstance/11483>\
**Category:** Configuration\
**Created:** [Novembre 2, 2026, 2:11 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483 "2026-11-02T14:11:24Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![Damien](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/damien/32/22156_2.png) [@Damien](https://community.gladysassistant.com/u/Damien)\
**Post date:** [Novembre 2, 2026, 2:11 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/1 "2026-11-02T14:11:24Z")

</div>

Bonjour à tous,

Je vais certainement changer mon installation, actuellement un mini PC assez ancien, pour un Beelink S13.

Je voulais savoir si il y avait dans la doc ou sur le forum un «&nbsp;tuto&nbsp;» expliquant la procédure pour d’une part, effacer l’ancien mini PC et pour se reconnecter sur la nouvelle installation.

Y’a t’il une façon de faire particulière ou il suffit simplement de se connecter après l’installation ? Est-ce que la sauvegarde via Gladys Plus permet, après l’installation de Gladys OS, de tout retrouver directement ?

Je vous remercie pour votre aide

---

<div class="post-metadata">

**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\
**Post date:** [Novembre 2, 2026, 2:31 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/2 "2026-11-02T14:31:58Z")

</div>

Salut @Damien,

Bon choix, le Beelink Mini S13 est justement le mini-PC qu’on recommande pour Gladys 🙂

Pour répondre directement : **oui, la sauvegarde Gladys Plus est faite pour ça**. À la fin de l’installation de Gladys Assistant OS, au lieu de créer un compte, tu cliques sur « Restauration Gladys Plus » et tu retrouves ton instance telle quelle : utilisateurs, maisons et pièces, appareils, scènes, tableaux de bord, configuration des intégrations et **tout l’historique des capteurs**. Zigbee2mqtt et Matter sont aussi restaurés, car Gladys enregistre leur configuration dans sa base chaque nuit.

Il y a juste quelques précautions à prendre. Voici la procédure dans l’ordre.

## 1. Avant de changer (sur l’ancien mini-PC)

1. **Note ta clé de sauvegarde** : Paramètres → Gladys Plus → « Clé de sauvegarde » (clique sur l’œil pour l’afficher). Les sauvegardes sont chiffrées avec cette clé : sans elle, impossible de les restaurer. ⚠ Ne déconnecte pas Gladys Plus sur l’ancienne instance avant de l’avoir notée, la déconnexion efface la clé de l’instance.
2. Si tu utilises l’intégration **MQTT** avec le broker installé par Gladys (pour des Tasmota, Shelly, etc.) : note aussi le nom d’utilisateur et le mot de passe MQTT (Intégrations → MQTT → Configuration). Ils te serviront à l’étape 3.
3. Si tu utilises **Node-RED** : exporte tes flows (menu ☰ → Exporter → Tous les flux). Ils ne sont pas dans la sauvegarde Gladys.
4. **N’appaire pas de nouvel appareil Zigbee ou Matter juste avant la migration.** La configuration de Zigbee2mqtt est sauvegardée dans Gladys tous les soirs à 23h, celle de Matter à 4h du matin. Un appareil appairé après la dernière sauvegarde de la nuit serait à ré-appairer.
5. **Lance une sauvegarde manuelle** : Paramètres → Sauvegardes → « Sauvegarder maintenant ». Attends qu’elle apparaisse dans la liste.
6. **Éteins l’ancien mini-PC.** Les deux machines ne doivent jamais tourner en même temps : elles piloteraient les mêmes appareils, tes scènes se déclencheraient en double, et elles partageraient la même connexion Gladys Plus.
7. Débranche ton dongle Zigbee (et tes autres dongles USB) et branche-le sur le Beelink. Si ton coordinateur Zigbee est un modèle réseau (SLZB-06, etc.), il n’y a rien à déplacer.

## 2. Installation du Beelink

Suis la doc de Gladys Assistant OS : [Installer Gladys Assistant sur un mini-PC avec Gladys Assistant OS | Gladys Assistant](https://gladysassistant.com/fr/docs/installation/mini-pc/)  
En résumé : tu écris l’image sur une clé USB, tu démarres le Beelink dessus (touche **F7** au démarrage), tu réponds à quelques questions, et Gladys s’installe toute seule.

Quand [http://gladysassistant.local](http://gladysassistant.local) affiche l’écran de bienvenue :

1. Clique sur **« Restauration Gladys Plus »** (et pas sur « Créer un compte local »).
2. Connecte-toi avec ton compte Gladys Plus (email, mot de passe, code de double authentification).
3. Saisis ta **clé de restauration** : c’est la clé de sauvegarde notée à l’étape 1.
4. Choisis la sauvegarde la plus récente, puis clique sur « Restaurer » et « Confirmer ».
5. À la fin, Gladys redémarre toute seule. Tu te connectes ensuite avec ton compte Gladys habituel, avec l’email et le mot de passe de ton ancienne instance.

La restauration prend plus ou moins de temps selon la taille de ton historique.

## 3. Vérifications après la restauration

- **Zigbee2mqtt** : Gladys le réinstalle automatiquement avec sa configuration restaurée (réseau Zigbee et appareils), donc pas besoin de ré-appairer. Va quand même dans Intégrations → Zigbee2mqtt vérifier le port USB du dongle : il peut porter un autre nom sur la nouvelle machine. Dans ce cas, sélectionne le bon.
- **Matter** : le contrôleur est restauré automatiquement depuis sa sauvegarde.
- **Intégrations du catalogue** : elles sont réinstallées automatiquement au démarrage. Gladys retélécharge leurs images, ce qui peut prendre quelques minutes.
- **MQTT** (si tu utilises le broker installé par Gladys) : en préparant cette réponse, je viens de me rendre compte que le conteneur du broker n’est pas recréé automatiquement après une restauration sur une nouvelle machine. Je corrige ça ! En attendant, dans Intégrations → MQTT → Configuration, clique sur « Installez le broker sur Docker ». Gladys génère alors un nouveau mot de passe : **remets tes anciens identifiants et sauvegarde** , sinon tes appareils MQTT ne pourront plus se connecter.
- **Node-RED** : réimporte tes flows.
- **Adresse IP** : le Beelink aura une nouvelle adresse IP. Tout ce qui contacte Gladys par son IP (appareils MQTT, etc.) doit utiliser la nouvelle. Le plus simple, une fois l’ancien éteint : dans les réglages de ta box, donne au Beelink l’adresse IP fixe qu’avait l’ancien mini-PC (réservation DHCP).
- **Gladys Plus** : ta connexion Gladys Plus fait partie de la sauvegarde, c’est donc le Beelink qui prend la place de l’ancien. Vérifie que l’instance est bien connectée dans Paramètres → Gladys Plus, et teste l’accès à distance sur [https://plus.gladysassistant.com](https://plus.gladysassistant.com). Le lendemain, vérifie qu’une nouvelle sauvegarde apparaît dans Paramètres → Sauvegardes.

## 4. Effacer l’ancien mini-PC

Garde-le éteint quelques jours, le temps de vérifier que tout fonctionne : c’est ton plan B. Ne le rallume jamais avec Gladys qui tourne pendant que le Beelink fonctionne.

Ensuite, son disque contient toujours ta base Gladys (utilisateurs, clés Gladys Plus, accès de tes intégrations). Donc :

- **si tu le donnes ou le revends** , réinstalle un système en effaçant complètement le disque ;
- **si tu le gardes pour autre chose** , supprime les conteneurs et les données de Gladys :

```bash
docker rm -f gladys gladys-z2m-zigbee2mqtt gladys-z2m-mqtt eclipse-mosquitto gladys-node-red

```

```bash
sudo rm -rf /var/lib/gladysassistant

```

Adapte la liste des conteneurs à ce que `docker ps -a` affiche chez toi (par exemple, ajoute `watchtower` s’il est installé).

Pas besoin de déconnecter Gladys Plus sur l’ancien mini-PC : c’est le Beelink qui a repris la connexion.

Si tu bloques à une étape, n’hésite pas à revenir ici !

---

<div class="post-metadata">

**Author:** ![Damien](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/damien/32/22156_2.png) [@Damien](https://community.gladysassistant.com/u/Damien)\
**Post date:** [Novembre 2, 2026, 2:43 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/3 "2026-11-02T14:43:37Z")

</div>

C’est très clair, merci beaucoup !

---

<div class="post-metadata">

**Author:** ![cursor-bot](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/cursor-bot/32/22252_2.png) [@cursor-bot](https://community.gladysassistant.com/u/cursor-bot)\
**Post date:** [Novembre 2, 2026, 2:45 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/4 "2026-11-02T14:45:05Z")

</div>

Salut tout le monde !

Ce sujet est désormais **en cours de développement**.

Une PR a été ouverte pour recréer le broker MQTT embarqué manquant avec les identifiants déjà enregistrés (après restauration d’une sauvegarde) :

> <https://github.com/GladysAssistant/Gladys/pull/3312>
>
> \### Description
> 
> When an instance using the MQTT integration with the \*\*embedded… broker\*\* (the \`eclipse-mosquitto\` container installed by Gladys) is restored from a Gladys Plus backup onto a new machine, the broker never comes back on its own:
> 
> \- the restored database holds the embedded broker configuration (\`MQTT\_EMBEDDED\_BROKER\`, \`MQTT\_MOSQUITTO\`, \`MQTT\_USERNAME\`, \`MQTT\_PASSWORD\`), but the container does not exist on the new machine;
> \- \`getConfiguration\` reports \`brokerContainerAvailable: false\`, and \`updateContainer\` only acts on an existing container, so nothing is recreated and the connection to \`mqtt://localhost\` fails;
> \- the only way out was the "Install the broker on Docker" button, which calls \`saveConfiguration\` with user \`gladys\` and a \*\*newly generated password\*\*. Every MQTT device configured with the old credentials then loses its connection until the user types the old password back in.
> 
> Zigbee2mqtt does not have this problem: \`installMqttContainer\` recreates its broker on init with the credentials stored in the DB.
> 
> \#### Change
> 
> New \`recreateMissingContainer(configuration)\` method (\`server/services/mqtt/lib/recreateMissingContainer.js\`), called by \`init\` between \`getConfiguration\` and \`updateContainer\`. It acts only when all of these are true:
> 
> \- the embedded broker is enabled (\`useEmbeddedBroker\`: Docker, host network mode, not switched to an external broker);
> \- Gladys actually configured it: a Mosquitto version is stored. \`useEmbeddedBroker\` is also \`true\` on a host-network instance where MQTT was never configured, so this check stops Gladys from installing a broker nobody asked for;
> \- credentials are stored (otherwise a warning is logged and nothing is done);
> \- \*\*no container at all\*\* carries the \`eclipse-mosquitto\` name. A user container, or a broker Gladys never configured, is left untouched, in line with \`findManagedContainer\` / \`isBrokerConfiguredByGladys\`.
> 
> It then runs \`installContainer(false)\` (no new credentials), starts the container, writes the \*\*stored\*\* user with \`mosquitto\_passwd -b\` (as \`saveConfiguration\` does), restarts the container so the broker loads the password file, and stores the Mosquitto version. The returned configuration has \`brokerContainerAvailable: true\`, so \`updateContainer\` does not run an upgrade afterwards, and \`connect\` uses the stored credentials.
> 
> If the recreation fails (for example, the image cannot be pulled), the error is logged and init goes on. The service still starts and the broker can be installed from the setup page, so the result is no worse than before this change.
> 
> Note: once the embedded broker is enabled, a container deleted by hand with \`docker rm\` is now recreated at the next start. To stop using the embedded broker, the user switches to an external broker in the MQTT setup page (this stores \`MQTT\_EMBEDDED\_BROKER = false\`).
> 
> \#### Tests
> 
> \- \`server/test/services/mqtt/lib/recreateMissingContainer.test.js\`: recreation with the stored credentials (labeled container, bind, exec, restart order, version stored, \`saveConfiguration\` never called), plus each case where nothing is done: container available, embedded broker not used, never configured, no credentials, user container carrying the name. Also a failed pull that does not crash.
> \- \`server/test/services/mqtt/lib/init.test.js\`: end-to-end \`init\` on a restored database. The container is recreated, no upgrade follows, and \`connect\` uses the stored username and password.
> 
> \### Related request
> 
> Forum: https://community.gladysassistant.com/t/changer-dinstance/11483
> 
> \### Checklist
> 
> \- \[x\] If a forum topic or GitHub issue exists, the description links it (\`Forum: https://community.gladysassistant.com/t/...\` or \`Closes #...\`)
> \- \[x\] Tests pass: \`cd server && npm run coverage\`. The new and changed files have 100% line and branch coverage. All 272 MQTT tests pass. The only failures in the full run are in the Gladys Plus gateway tests and one integration host API test, which call the network and fail the same way on unmodified \`master\` in the sandbox where this was developed. No UI change, so no Cypress.
> \- \[x\] Linter and prettier pass on the server (\`npm run eslint\`, \`npm run prettier-check\`). The front was not touched.
> \- \[x\] No undocumented breaking change
> 
> \---
> \_Generated by \[Claude Code\](https://claude.ai/code/session\_01MNjB35hjvuLD4XVykHfJvs)\_

N’hésitez pas à suivre la PR, à tester (optionnel, surtout pour les petites demandes) et à faire vos retours ici si besoin.

---

<div class="post-metadata">

**Author:** ![StephaneB](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/stephaneb/32/15443_2.png) [@StephaneB](https://community.gladysassistant.com/u/StephaneB)\
**Post date:** [Novembre 2, 2026, 4:51 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/5 "2026-11-02T16:51:53Z")

</div>

Ça va m’être très utile aussi, cette procédure pas à pas ! Merci @pierre-gilles

---

<div class="post-metadata">

**Author:** ![StephaneB](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/stephaneb/32/15443_2.png) [@StephaneB](https://community.gladysassistant.com/u/StephaneB)\
**Post date:** [Novembre 2, 2026, 4:53 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/6 "2026-11-02T16:53:45Z")

</div>

J’y pense : ça aurait peut-être sa place dans une page de la doc officielle ?

---

<div class="post-metadata">

**Author:** ![pierre-gilles](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/pierre-gilles/32/5886_2.png) [@pierre-gilles](https://community.gladysassistant.com/u/pierre-gilles)\
**Post date:** [Novembre 2, 2026, 5:43 UTC](https://community.gladysassistant.com/t/changer-dinstance/11483/7 "2026-11-02T17:43:13Z")

</div>

> **[Changer de machine (migrer Gladys vers un nouveau serveur) | Gladys Assistant](https://gladysassistant.com/fr/docs/installation/migrate/)**
>
> Vous remplacez votre mini-PC, votre Raspberry Pi ou votre serveur ? Voici comment déplacer Gladys Assistant vers une nouvelle machine grâce à une sauvegarde Gladys Plus, sans ré-appairer vos appareils, puis effacer proprement l'ancienne.