FoldersFolders and files
On this page
The install
| Folder | What's in it | Back it up? |
|---|---|---|
~/RoachNet/app |
RoachNet.app. Its helper is RoachNet.app/Contents/Helpers/roachnet-runtime. |
No |
~/RoachNet/runtime, ~/RoachNet/bin |
Support files Setup manages | No |
~/RoachNet/setup |
RoachNet Setup, when you installed with Homebrew | No |
~/RoachNet/storage |
Your data: see below | Yes |
~/Library/Application Support/roachnet |
roachnet-installer.json, the installer's settings, including the companion token's SHA-256 (the token itself before 1.1.3) |
No |
Upgrades replace app, runtime and bin, and keep storage.
Inside storage
| Folder | What's in it |
|---|---|
Vault/ |
Your Vault |
RoachClaw/ |
RoachClaw's state, with the Org in RoachClaw/org/ |
models/ |
Local models |
maps/pmtiles/ |
Map packs |
zim/ |
Kiwix and Wikipedia archives |
RoachSpeech/ModelPacks/ |
Speech models |
packs/ |
Feature packs, and packs/retired/ for data you chose to retire |
themes/ |
Your themes, and the active theme the companion reads |
cluster/shards/ |
Model shards other Macs sent for Cluster |
state/ |
Settings and state, including traces/, cluster.json and runtime-state/ |
logs/ |
The runtime's log, roachnet-native-api.log |
state/runtime-state/native-server-info.json is written each time RoachNet.app starts the runtime, with that launch's address. It's readable by your account only, and since 1.1.3 it holds no token. Find the port and token reads it.
What to back up
Back up ~/RoachNet/storage. Copy it while RoachNet is quit, or let Time Machine include it. Everything else can be reinstalled.
Deletes your data
brew uninstall --zap --cask roachnet deletes ~/RoachNet, storage included. Deleting ~/RoachNet/storage by hand does the same.
Related
- Upgrade, roll back or remove
- Environment variables can move storage for a runtime you start yourself.