====== Installing Node-RED for Unipi ======
This article covers the installation of Node-RED software on any Unipi unit. 
For older systems (Debian 12 and older) OS images are available, but it is recommended to use newest Base OS (or Debian) version for security reasons.
Older Node-RED OS images can be found under products in sections OS images > Node-RED in Archive tab.

----

This article presumes Base OS is present on the Unipi unit.
This system does not include Node-RED, but it is possible to install Node-RED on it.
If Base OS is not present on the unit, it is recommended the [[en:files:software:os-images:00-start|newest version is installed]] to avoid any problems with compatibility.

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Note:** \\
This article contains installation of Node-RED with API [[cs:sw:02-apis:01-evok|Evok]].
Evok is not a mandatory part of the installation, but it can simplify the access to I/O.
Evok can be omitted, if access to I/O is not needed or different way for access is used.
</WRAP>
</WRAP>

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Note:** \\
To make sure you have the latest version of Base OS, upload the OS according to the Upload/backup OS guide under each product. For example for Unipi Patron the guide is located at [[en:hw:007-patron:image|Products > Unipi Patron > Upload/backup OS]]
Image with Base OS can be found in [[en:files:software:os-images:00-start|OS images]] section or under products in downloads section.
</WRAP>
</WRAP>

{{page>install-nodered-hidden}}

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:09_safety-instructions_pseudo-ISO-7010-attention.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Attention:** \\
If you have problems seeing Node palette or see errors regarding nodejs compatibility, then this might indicate a problem with memory overcommitment. 
----
This problem can be fixed simply by editing file **/etc/sysctl.d/80-ram-overcommit.conf** and changing line <code>vm.overcommit_memory = 2</code> to <code>vm.overcommit_memory = 0</code>

then restart the unit
<code>sudo reboot</code>

----
Changing this setting can have impact on system behavior. More information can be found at https://www.kernel.org/doc/Documentation/vm/overcommit-accounting.

</WRAP>
</WRAP>

{{page>connection-to-edge-hidden}}

{{page>install-packages-hidden}}