First push of docs

on-boot-script/README.md

@@ -0,0 +1,69 @@
+# UDM / UDMPro Boot Script
+### Features
+1. Allows you to run a shell script at S95 anytime your UDM starts / reboots
+
+All files described here are in the examples folder, automation is coming soon.
+
+
+Steps
+# 1. Make your script on the UDM/UDMPRO
+```
+vi /mnt/data/on_boot.sh 
+chmod u+x /mnt/data/on_boot.sh
+```
+Example: see examples/udm-files/on_boot.sh
+```
+#!/bin/sh
+podman start wpa_supplicant-udmpro
+
+iptables -t nat -C PREROUTING -p udp ! --source 10.0.0.x ! --destination 10.0.0.x --dport 53 -j DNAT --to 10.0.0.x || iptables -t nat -A PREROUTING -p udp ! --source 10.0.0.x ! --destination 10.0.0.x --dport 53 -j DNAT --to 10.0.0.x
+iptables -t nat -C PREROUTING -p tcp ! --source 10.0.0.x ! --destination 10.0.0.x --dport 53 -j DNAT --to 10.0.0.x || iptables -t nat -A PREROUTING -p tcp ! --source 10.0.0.x ! --destination 10.0.0.x --dport 53 -j DNAT --to 10.0.0.x
+iptables -t nat -C POSTROUTING -j MASQUERADE || iptables -t nat -A POSTROUTING -j MASQUERADE
+```
+
+# 2. Make the unifios docker container execute this script on startup, this has to be done after every firmware update.  It does persist through reboots.
+```
+podman exec -it unifi-os sh
+
+ssh root@127.0.01 # this is to accept the fingerprint of the udm
+exit # back to the container shell
+```
+
+### make a script that sshs to the udm and runs on our boot script
+Example: examples/unifi-os-files/udm.sh
+```
+echo "#!/bin/sh
+ssh root@127.0.1.1 '/mnt/data/on_boot.sh'" > /etc/init.d/udm.sh # 127.0.1.1 always points to the UDM
+```
+#### make said script executable
+```
+chmod u+x /etc/init.d/udm.sh
+```
+### make a service that runs on startup, after we have networking
+Example: examples/unifi-os-files/udmboot.service
+```
+echo "[Unit]
+Description=Run On Startup UDM
+
+[Service]
+After=network.target
+ExecStart=/etc/init.d/udm.sh
+
+[Install]
+WantedBy=multi-user.target" > /etc/systemd/system/udmboot.service
+```
+
+### enable it and test
+```
+systemctl enable udmboot
+systemctl start udmboot
+```
+### back to the udm
+```
+exit
+```
+# reboot your udm/udmpro and make sure it worked
+```
+reboot
+exit
+```

on-boot-script/examples/udm-files/on_boot.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+podman start wpa_supplicant-udmpro
+

on-boot-script/examples/unifi-os-files/udm.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+ssh root@ubnt '/mnt/data/on_boot.sh'

on-boot-script/examples/unifi-os-files/udmboot.service

@@ -0,0 +1,9 @@
+[Unit]
+Description=Run On Startup UDM
+
+[Service]
+After=network.target
+ExecStart=/etc/init.d/udm.sh
+
+[Install]
+WantedBy=multi-user.target