Differences

This shows you the differences between two versions of the page.

--- packet:bpqmonweb [2025/04/12 21:08] – created m0lte
+++ packet:bpqmonweb [2025/04/19 19:05] (current) – m0mzf
@@ Line 1: / Line 1: @@
-====== bpqmonweb ======
+====== Tom 2E0JJI's bpqmonweb ======
+Tom has created a superb web application to monitor a BPQ or Xrouter node.
+{{:packet:bqmon.png?nolink&956}}
+==== Set up using Docker ====
+< To do >
+==== Set up manually ====
+This involves installing a web server & MQTT broker and configuring the whole lot. This is on a Pi running Raspberry Pi OS 12 - let's start with installing the required packages:
+<code> sudo apt install -y git nginx mosquitto </code>
+Grab Tom's repository and copy everything into the web server
+<code>
+mkdir ~/src; cd ~/src
+git clone https://github.com/packethacking/bpqmonweb.git
+cd ~/src/bpqmonweb
+sudo rm /etc/nginx/sites-enabled/default
+sudo cp nginx/nginx.conf /etc/nginx/sites-enabled/bpqmonweb
+sudo cp *.html /usr/share/nginx/html/
+sudo cp *.css /usr/share/nginx/html/
+sudo cp *.js /usr/share/nginx/html/
+</code>
+Now we need to add an entry to our hosts file so the nginx proxy knows where mosquitto is located on the network; this is already set in the nginx config so it's cleaner to add it here rather than edit the files pulled from git
+<code>echo "127.0.0.1	mosquitto" | sudo tee -a /etc/hosts</code>
+Then we need to set up mosquitto users - replace the supersecretbpqmqttpassword with something "secret" so other people can't publish to your MQTT server!
+<code>
+echo "linbpquser:supersecretbpqmqttpassword" | sudo tee /etc/mosquitto/bpqpasswd
+echo "bpqmonweb:bpqmonweb" | sudo tee /etc/mosquitto/webpasswd
+sudo mosquitto_passwd -U /etc/mosquitto/bpqpasswd
+sudo mosquitto_passwd -U /etc/mosquitto/webpasswd
+</code>
+and create some configuration files for mosquitto to enable publishing and websocket access
+<code>
+echo 'per_listener_settings true
+listener 1883
+password_file /etc/mosquitto/bpqpasswd
+allow_anonymous false
+listener 9001
+protocol websockets
+password_file /etc/mosquitto/webpasswd
+acl_file /etc/mosquitto/webaclfile
+allow_anonymous false' | sudo tee /etc/mosquitto/conf.d/bpqmonweb.conf
+</code>
+and create an access control list so publishing to the publicly-available user can only read the topic
+<code>
+echo 'user bpqmonweb
+topic read PACKETNODE/ax25/trace/bpqformat/#' | sudo tee /etc/mosquitto/webaclfile
+</code>
+Now we need to tell LinBPQ to publish to the MQTT broker; add the following lines to your /etc/bpq32.cfg
+Remember to use the super secret password you created above; the hostname "mosquitto" is resolved from /etc/hosts
+<code>
+MQTT=1
+MQTT_HOST=mosquitto
+MQTT_PORT=1883
+MQTT_USER=linbpquser
+MQTT_PASS=supersecretbpqmqttpassword
+</code>
+then restart all the services we've tinkered with
+<code>
+sudo systemctl restart mosquitto.service
+sudo systemctl restart linbpq.service
+sudo systemctl restart nginx.service
+</code>
+Now you can access the web server and watch the packet racket!
+<code> http://your.pi.ip.address </code>