====== 🚀 Installing Node-RED on Raspberry Pi ======

Node-RED is a powerful flow-based development tool for visual programming, ideal for IoT and automation projects. This guide walks you through installing Node-RED on a Raspberry Pi running Raspberry Pi OS.

===== 🧰 Requirements =====
  * 🖥️ Raspberry Pi (Pi 3 or later recommended)
  * 🐧 Raspberry Pi OS (Bullseye or newer)
  * 🌐 Internet connection
  * 🔧 Terminal access (SSH or direct login)

===== 📦 Installation Steps =====

==== 🔄 1. Update Your System ====
Keep your system up to date before installing:

<code bash>
sudo apt update && sudo apt upgrade -y
</code>

==== 📥 2. Run the Official Install Script ====
Use the Node-RED team's optimized installer:

<code bash>
bash <(curl -sL https://raw.githubusercontent.com/node-red/linux-installers/master/deb/update-nodejs-and-nodered)
</code>

This script will:
  * Install the latest Node.js LTS
  * Install Node-RED globally
  * Configure Node-RED as a systemd service

==== 👤 3. Add Your User to Node-RED Group ====
To manage the Node-RED service:

<code bash>
sudo usermod -aG node-red pi
</code>

Replace `pi` with your actual username if different.

==== ▶️ 4. Enable and Start Node-RED ====

<code bash>
sudo systemctl enable nodered.service
sudo systemctl start nodered.service
</code>

==== 🌐 5. Access the Node-RED Editor ====
Open your browser and go to:

<code>
http://<your-pi-ip>:1880
</code>

You should see the Node-RED flow editor.


===== 🛠️ Troubleshooting =====
  * Check service status: `sudo systemctl status nodered.service`
  * View logs: `journalctl -u nodered -f`
  * Reinstall Node-RED: rerun the install script

===== 📚 Resources =====
  * 🌐 [[https://nodered.org/docs/getting-started/raspberrypi|Official Node-RED Raspberry Pi Guide]]
  * 🔄 [[https://flows.nodered.org/|Node-RED Flow Library]]
  * 💬 [[https://discourse.nodered.org/|Node-RED Community Forum]]

====== Code / Projects / Flows ======
Coming soon