BrewThe RoachNet cask

The cask installs the same release as the DMG, on an Apple Silicon Mac with macOS 14 or later, and keeps your data across upgrades.

macOS 1.1.4Homebrew cask1 min read
On this page

Install

Terminal
brew tap --force RoachWares/roachnet
brew install --cask roachnet
open ~/RoachNet/app/RoachNet.app

What the cask does

It's more than a brew install in a trenchcoat. The cask runs RoachNet's own installer:

  • It downloads the same RoachNet-Setup-macOS.dmg as the release and checks it against the published SHA-256. For 1.1.4 that's 3c9cbefc3d68a0eddd633b74dbcda06d56931a4a6176283d5a597de6950305fe.
  • It puts RoachNet Setup in ~/RoachNet/setup, then runs Setup's headless installer, roachnet-runtime --install. That's the same install the Setup app does, with the companion bridge left off.
  • The app lands in ~/RoachNet/app and your data in ~/RoachNet/storage. Existing storage is kept.

The companion bridge stays off until you turn it on in the app, which you only need to pair a phone. See Install the iOS companion.

Upgrade

Terminal
brew upgrade --cask roachnet

An upgrade runs the installer over the existing install and keeps ~/RoachNet/storage.

If brew update shows an error for roachwares/roachnet, run brew update-reset "$(brew --repo roachwares/roachnet)" once.

Remove

Terminal
# removes RoachNet Setup; the app and ~/RoachNet/storage stay
brew uninstall --cask roachnet
Deletes your data

brew uninstall --zap --cask roachnet also deletes ~/RoachNet and RoachNet's settings: your Vault, models, maps, Org and traces. Copy ~/RoachNet/storage somewhere first if you want to keep any of it.

Checked against v1.1.4 · 5 November 2026
esc
↑ ↓ move↵ openesc closeSearches on your device. Nothing is sent anywhere.