Skip to content
PulseRN

Desktop installation

PulseRN desktop builds are published through GitHub Releases. Preview releases are unsigned.

Homebrew

Section titled “Homebrew”
Terminal window
brew tap maahibhama/pulsern https://github.com/maahibhama/PulseRN
brew install --cask --no-quarantine pulsern

Upgrade or remove it:

Terminal window
brew update
brew upgrade --cask pulsern
brew uninstall --cask pulsern
brew untap maahibhama/pulsern

Use brew uninstall --cask --zap pulsern to also remove settings and the local event database.

macOS DMG

Section titled “macOS DMG”
  1. Download PulseRN-<version>-mac-arm64.dmg for Apple Silicon or PulseRN-<version>-mac-x64.dmg for Intel.
  2. Open the DMG and drag PulseRN to Applications.
  3. If Gatekeeper blocks it, right-click PulseRN and select Open.

Removing the app does not remove data under ~/Library/Application Support/PulseRN.

Windows

Section titled “Windows”

Use PulseRN-<version>-windows-x64-setup.exe for most PCs or the ARM64 installer for Windows on ARM. If SmartScreen appears, select More info → Run anyway. Uninstall from Settings → Apps → Installed apps.

Linux

Section titled “Linux”

Run the x86-64 AppImage:

Terminal window
chmod +x PulseRN-<version>-linux-x64.AppImage
./PulseRN-<version>-linux-x64.AppImage

Or install the Debian package:

Terminal window
sudo apt install ./PulseRN-<version>-linux-x64.deb

Linux ARM packages are not currently available.

Verify a download

Section titled “Verify a download”

Download SHA256SUMS.txt beside the installer:

Terminal window
# Linux
sha256sum --check SHA256SUMS.txt


# macOS
shasum --algorithm 256 --check SHA256SUMS.txt

The checksum file covers every artifact, so missing-file messages are expected when you downloaded only one. The selected installer must report OK.

Expected result

Section titled “Expected result”

PulseRN opens, listens locally on port 9090, and is ready for an SDK connection. The first-run checklist verifies the SDK, debugger port, device, Metro/Hermes, and first event. Continue with Getting started.

Troubleshooting

Section titled “Troubleshooting”
  • Security warnings are expected for unsigned preview builds.
  • If port 9090 is occupied, stop the conflicting process; the SDK and desktop port must match.
  • Physical devices are supported through authenticated LAN pairing.
  • Automatic updates are available only in eligible signed packaged builds; unsigned previews use direct downloads.