diff --git a/docs/user/mirror.md b/docs/user/mirror.md
index 5c82ea6cb0a3aa6583218648eba9a6be93e4425f..0e3ecccd63a46aafc011493a18b4a4550c0e1a81 100644
--- a/docs/user/mirror.md
+++ b/docs/user/mirror.md
@@ -58,3 +58,11 @@ and replace `YOUR_DOMAIN` by your domain each time.
 Your node is now online as a mirror node. It's fully capable for wallet use.
 
 To go further, read [How to become a (black)smith](./smith.md)
+
+## Upgrade your node with minimal interruption
+
+1. Modify docker image tag on your compose file
+2. Run `docker compose pull`, this will pull the new image.
+3. Run `docker compose up -d --remove-orphans`, this will recreate the container
+4. Verify that your node restarted well `docker compose logs duniter-rpc`
+5. Remove the old image `docker images rmi duniter/duniter-v2s:OLD_TAG`
diff --git a/docs/user/smith.md b/docs/user/smith.md
index 7da79154cb2405ce83ed3984239d8e7831d61c15..d29f3d29d0293c094d43b583771416c0ceb5549c 100644
--- a/docs/user/smith.md
+++ b/docs/user/smith.md
@@ -85,3 +85,10 @@ When you have at least 3 certifications, your'in !
   - In the UI : developer > extrinsics > YOUR_SMITH_ACCOUNT > authorityMembers > goOnline()
 
 If you're not able to monitor, reboot, act on your node, goOffline() to avoid penality to the blockchain and to you.
+## Upgrade your node with minimal interruption
+
+1. Modify docker image tag on your compose file
+2. Run `docker compose pull`, this will pull the new image.
+3. Run `docker compose up -d --remove-orphans`, this will recreate the container
+4. Verify that your node restarted well `docker compose logs duniter-validator`
+5. Remove the old image `docker images rmi duniter/duniter-v2s:OLD_TAG`