Skip to content

Commit 5abe9e9

Browse files
dathberejasKristjanESPERANTO
authored
Add instructions for upgrading node when upgrade of MM fails (#301)
Co-authored-by: Veeck <[email protected]> Co-authored-by: Kristjan ESPERANTO <[email protected]>
1 parent 1734eb1 commit 5abe9e9

File tree

1 file changed

+24
-2
lines changed

1 file changed

+24
-2
lines changed

getting-started/upgrade-guide.md

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ start the upgrade process!
77

88
:::
99

10+
## Manual Upgrade
11+
1012
If you want to update your MagicMirror² to the latest version, use your terminal
1113
to go to your MagicMirror folder and type the following command:
1214

@@ -27,5 +29,25 @@ the source code, so only execute this if you know what you are doing!
2729
Type `git status` to see your changes, if there are any, you can reset them with
2830
`git reset --hard`. After that, `git pull` should be possible.
2931

30-
If you want to try the community maintained automated update then, please see
31-
[alternative installation methods](installation.md#alternative-installation-methods)
32+
MagicMirror² updates may change the minimum version of `Node.js` that is required,
33+
and the installation script above may fail if your system does not meet that
34+
minimum requirement. You can find information on installing newer versions of
35+
`Nodes.js` [here](https://github.com/nodesource/distributions) and
36+
[here](https://nodejs.org/en/download). And you can find information on the minimum
37+
version of `Node.js` that is required by MagicMirror²
38+
[here](https://github.com/MagicMirrorOrg/MagicMirror/releases) or by running the
39+
upgrade script above and reading any error messages.
40+
41+
## Alternative Upgrade Methods
42+
43+
::: tip NOTE
44+
45+
Users who prefer a straightforward, automated solution may find alternative methods more practical. Although convenient, not using the manual method above may mean that you gain less insight into the system, which could make it harder to troubleshoot issues independently.
46+
47+
:::
48+
49+
### Community-Maintained Automatic Upgrade Script
50+
51+
Sam (@sdetweil, long time contributor of the MagicMirror² framework) maintains an
52+
easy-to-use update script:
53+
[https://github.com/sdetweil/MagicMirror_scripts](https://github.com/sdetweil/MagicMirror_scripts/?tab=readme-ov-file#upgrade-to-next-magicmirror-version-from-an-existing-installation)

0 commit comments

Comments
 (0)