> For the complete documentation index, see [llms.txt](https://daton.gitbook.io/daton-mac/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://daton.gitbook.io/daton-mac/iot.md).
# IoT
## Node RED
I decided to build my first IoT project to automate my small garden with Peperoncini and Tomatos plants.
For development purpose we may want to install Node Red under Docker on our local machine.
#### Quick install
To run the `latest` container (we use `slim` tag for alpine linux since we don't need native dependencies):
```bash
docker run -it -p 1880:1880 -v ~/data-db/node-red-data:/data --name nodered nodered/node-red-docker:slim
```
{% hint style="info" %}
On a Raspberry Pi you must use a `rpi`-tagged image: `nodered/node-red-docker:rpi`.
{% endhint %}
{% hint style="info" %}
On Windows we need to create the volume first:
docker volume create --name nodered
Then replace the volume option with -v nodered:/data.
{% endhint %}
Hit `Ctrl-p` `Ctrl-q` to detach from the container. This leaves it running in the background.
To reattach to the container:
```bash
docker attach nodered
```
Now we can open the browser and navigate to .
### Install the Node RED Dashboard
Click on the top right menu icon and select Manage Palette, click the Install tab, then search node-red-dashboard and install it.
To check that the dashboard is correctly installed navigate to .
Read this [Tutorial ](https://randomnerdtutorials.com/getting-started-with-node-red-dashboard/)to set up a Dashboard.
### Deploy Node RED in production
[Securing Node RED](https://nodered.org/docs/user-guide/runtime/securing-node-red#http-node-security).
## Mosquitto
Mosquitto is a very popular MQTT Broker.
We can now create 3 volumes to:
1. Override the default mosquitto.conf.
2. To give a persistent data folder.
3. To give a persistent log folder.
{% hint style="info" %}
On Windows we need to create the volumes into C:/docker-volume/ but not in C:/Users/YOUR\_USER/SOMETHING because we finish to have permission issues.
{% endhint %}
Create a file for configure persistence and logs:
{% code title="mosquitto.conf" %}
```
persistence true
persistence_location /mosquitto/data/
log_dest file /mosquitto/log/mosquitto.log
```
{% endcode %}
Run the container:
```bash
docker run --name mqttbroker -d -p 1883:1883 -p 9001:9001 -v c:/docker-volume/mosquitto/mosquitto.conf:/mosquitto/config/mosquitto.conf -v c:/docker-volume/mosquitto/data:/mosquitto/data -v c:/docker-volume/mosquitto/log:/mosquitto/log eclipse-mosquitto
```
More info on the [Mosquitto Official Docker Hub Image](https://hub.docker.com/_/eclipse-mosquitto).
## Testing MQTT
There’s a handy free program called [MQTT.fx](http://mqttfx.org/) which is available for Mac, Windows and Linux. Or if you’re using Chrome there’s a free Chrome Extension called [MQTT Lense](https://chrome.google.com/webstore/detail/mqttlens/hemojaaeigabkbcookmlgmdigohjobjm?hl=en).
In MQTT.fx, press the settings icon to setup a new connection. We’ll use the server address details above for this. Once we’ve setup our new connection, select it from the list and press the blue connect button.
[](https://i0.wp.com/philhawthorne.com/wp-content/uploads/2017/07/mqtt-fx-connect.png?ssl=1)
Once you’ve connected to your MQTT server, we should first “subscribe” to a topic. Let’s move to the subscribe tab, and enter a topic to subscribe to. For now, let’s choose the topic home/garden/fountain which is the default for MQTT fx.
[](https://i2.wp.com/philhawthorne.com/wp-content/uploads/2017/07/mqtt-subscribe.png?ssl=1)
Now that we’ve subscribed to our topic, let’s move back to the Publish tab, and now we’ll send a message on the home/garden/fountain topic. In the message body, let’s type “hello world!” and then press the blue Publish button.
[](https://i0.wp.com/philhawthorne.com/wp-content/uploads/2017/07/mqtt-send-message.png?ssl=1)
If we switch back to the Subscribe tab, we should now see our home/garden/fountain topic has a message with hello world!
## Openhabian
### VPN
We may need to access the infrastructure from outside of our private network.
To do that we need to setup a VPN connection.
OpenVPN was added following this \[guide]\(
To use the openvpn official service (on boot as well) follow this \[link]\(
To use the port forwarding and host the OpenVPN server directly on the raspberry follow this \[link]\(
To make the VPN start on boot edit the rc.local file:
`sudo nano /etc/rc.local`
At the end of the file add this content:
```bash
## Connecto to the OpenVPN
echo "Connect to OpenVPN..."
nmcli connection up openhabian
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://daton.gitbook.io/daton-mac/iot.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.