UpgradeRoll back or remove

Your data lives in ~/RoachNet/storage, apart from the app. Upgrades keep it, and removing RoachNet leaves it unless you delete it yourself.

macOS 1.1.41 min read
On this page

Upgrade

  1. Back up ~/RoachNet/storage if you can. It holds your Vault, settings, models and Org.

  2. Quit RoachNet.

  3. Run the new RoachNet Setup over the existing install. Storage is kept, and the 1.1 installer also removes the Ollama runner that 1.0.x bundled.

With Homebrew, brew upgrade --cask roachnet does the same.

RoachNet also checks GitHub for its own releases. When it downloads an update, it checks the installer against the release's .sha256 file and deletes a download that doesn't match.

Update the iOS companion

If you installed RoachNetiOS from the RoachNet source, new versions show up in SideStore or AltStore. If you installed the IPA by hand, install the new IPA the same way; that normally keeps the app's data.

Roll back

Rolling back isn't tested

Going back to 1.0.7 over storage that 1.1 has used isn't tested. Webhook secrets saved by 1.1 are stored in a format 1.0.7 can't check, so re-create them after a rollback. Keep a copy of your storage from before the upgrade if you might want to go back.

To roll back, quit RoachNet, put back the copy of ~/RoachNet/storage you made before upgrading, and run the older RoachNet Setup. Going back to 1.0.6 from 1.0.7 brings back the security hole 1.0.7 fixed.

Remove

  1. Quit RoachNet.

  2. Delete ~/RoachNet/app and ~/RoachNet/runtime.

  3. Keep ~/RoachNet/storage if you want your data, or delete it too.

There's no one-click uninstaller. With Homebrew, brew uninstall --cask roachnet removes RoachNet Setup and keeps the app and your data.

Deletes your data

brew uninstall --zap --cask roachnet deletes ~/RoachNet and RoachNet's settings, including your Vault and models. Copy ~/RoachNet/storage first if you want to keep anything.

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