Desktop Setup Guide
This guide explains how to install and run the Network Debugger desktop app on macOS, Windows, and Linux.
For full build and release internals, see the extended document:
Download
Get desktop artifacts from GitHub Releases.
Installation
macOS
- Download the DMG for your architecture:
- Intel:
NetworkDebugger-*-macos-x86_64.dmg - Apple Silicon:
NetworkDebugger-*-macos-arm64.dmg
- Intel:
- Open DMG and drag app to Applications
- If macOS blocks first run, open: System Settings → Privacy & Security → Open Anyway
Windows
- Download
NetworkDebugger-*-windows-amd64.zip - Extract archive
- Run
install.bat - App is installed to
%LOCALAPPDATA%\NetworkDebugger
Linux
Debian/Ubuntu (.deb)
bash
sudo dpkg -i network-debugger_*_amd64.deb
network-debuggerAny distro (tar.gz)
bash
tar -xzf NetworkDebugger-*-linux-amd64.tar.gz
cd NetworkDebugger-*
./install.sh
network-debuggerFirst launch
On first start, configure:
- API Server Port (default
9092) - Forward Proxy Port (default
9091)
Ports must be available and different from each other.
Verify setup
- Launch desktop app
- Start your mobile/web/desktop client with debugger package integration
- Confirm sessions appear in the UI