From 066a941ce189b6039a8efdd4cd9bd51d7cdeacdb Mon Sep 17 00:00:00 2001
From: Sander van de Graaf <sander@vandegraaf.nl>
Date: Tue, 23 Jun 2026 12:13:12 +0200
Subject: [PATCH] Add Orb to dpkg cache for a better of update survival. Enable
 zeroconf publish and pick a more suitable port

---
 docs/setup-sensor/unifi-routers.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/setup-sensor/unifi-routers.md b/docs/setup-sensor/unifi-routers.md
index a37b5d5..61b0eea 100644
--- a/docs/setup-sensor/unifi-routers.md
+++ b/docs/setup-sensor/unifi-routers.md
@@ -48,14 +48,19 @@ curl -fsSL https://pkgs.orb.net/stable/ubuntu/ubuntu.orbforge-keyring.list | sud
 # disable mdns discovery, as it collides with Protect ports
 cat <<'EOD' > /etc/default/orb
 ORB_ZEROCONF_BROWSE=0
-ORB_ZEROCONF_PUBLISH=0
+ORB_ZEROCONF_PUBLISH=1
 ORB_FIRSTHOP_DISABLED=1
 ORB_EPHEMERAL_MODE=1
+# We need to set a port because our default ports can clash with the Protect ports if running
+ORB_SENSOR_API_PORT=7555
 EOD
 
 # install Orb (no-op if already installed)
 sudo apt-get update && sudo apt-get install orb
 
+# add the orb package to the dpkg-cache so we have a better chance of surviving a reinstall
+echo 'DPKG_CACHE_UBNT_PKGS+=" orb"' >> /etc/default/ubnt-dpkg-cache
+
 # enable auto-update
 sudo systemctl enable --now orb-update.timer
 EOF
@@ -74,3 +79,6 @@ sudo -u orb orb link
 ```
 
 5. Done
+
+> [!NOTE]
+> Future Unifi OS upgrades might cause issues with your installation of Orb, especially with major version releases. If this happens, rerunning the script is usually good enough to get things up and running again.