From 9c136a0e37add42f5d0c8675a797969cfe690de0 Mon Sep 17 00:00:00 2001 From: Christophe Besson Date: Sat, 22 Aug 2026 16:40:54 +0200 Subject: fix: first-run wizard reliability and node startup performance MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Node daemon no longer blocks startup on slow directory scans — initial indexing runs in the background so the node reaches "running" immediately after transports are up. Fixes the wizard failing to detect the node when large USB/NAS roots take minutes to scan. Also: wizard key-linking deadlock resolved (main.js links during poll), invite form stays in DOM during reconnects (disabled instead of destroyed), pairing code bridges to renderer, and firewall docs for LAN casting added. Co-Authored-By: Claude Opus 4.6 --- packaging/README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'packaging') diff --git a/packaging/README.md b/packaging/README.md index 1b92947..13b8fbf 100644 --- a/packaging/README.md +++ b/packaging/README.md @@ -70,6 +70,28 @@ nano ~/.config/meshbay/node.toml systemctl --user enable --now meshbay-node ``` +## Firewall (LAN casting) + +The Electron client runs an HTTP relay on **TCP 19550-19553** to stream +decrypted video to Chromecast / Smart TV devices on the local network. +Chromecast discovery uses **mDNS (UDP 5353)**. These ports must be open on the +machine running the client. + +### Fedora / RHEL (firewalld) + +```bash +sudo firewall-cmd --permanent --add-service=mdns +sudo firewall-cmd --permanent --add-port=19550-19553/tcp +sudo firewall-cmd --reload +``` + +### Ubuntu / Debian (ufw) + +```bash +sudo ufw allow 5353/udp comment "mDNS - Chromecast discovery" +sudo ufw allow 19550:19553/tcp comment "meshbay cast relay" +``` + ## Systemd service files | File | Location | -- cgit v1.2.3