Uninstall

1. Free your license seat#

Do this first, while onestation is still installed, so the seat can be used on another Mac. A license covers 2 Macs at a time.

1. Open License settings

   onestationSettings… (⌘,)License

2. Deactivate this Mac

   Click Deactivate this Mac… and confirm. You can also click Manage devices and Deactivate… next to any Mac in the list, for example one you no longer have.

Uninstalling does not cancel a subscription. To stop renewals, see Manage billing or cancel.

2. Revoke phones and servers#

In the onestation window, open SettingsPhone & devices and click Revoke next to each phone, then do the same in SettingsMachines for each server or other Mac. They are disconnected within seconds. Removing the software from them is covered below.

3. Remove the app#

1. Quit onestation

   Click the onestation menu bar icon and choose Quit onestation. If an answer is still in its two-second undo window, onestation waits until it is sent or cancelled; try again a moment later.

2. Remove it from Login Items

   If you turned on Launch at login, open System SettingsGeneralLogin Items & Extensions (on macOS 13 and 14: Login Items), select onestation under Open at Login and click –. Or turn off Launch at login in onestationSettings… (⌘,) before you quit.

3. Clear its privacy permissions (optional)

   Accessibility, Microphone, Speech Recognition and Automation otherwise stay listed in System SettingsPrivacy & Security. Run this before you move the app to the Trash, because tccutil can’t find the app once it’s gone:

   tccutil reset All dev.onestation.app

4. Move the app to the Trash

   In Finder, open Applications and drag onestation to the Trash, then empty the Trash.

4. Delete your data (optional)#

The app leaves its data behind in case you reinstall. To remove it, run these in Terminal.

Inbox, settings and logs#

Inbox state, settings, keys for paired devices and the log hub.log live in ~/.onestation:

rm -r ~/.onestation

macOS app files#

Window positions, the setup progress and the app’s web storage:

rm -rf ~/Library/Preferences/dev.onestation.app.plist \
  ~/Library/Caches/dev.onestation.app \
  ~/Library/WebKit/dev.onestation.app \
  ~/Library/HTTPStorages/dev.onestation.app

onestation keeps nothing in ~/Library/Application Support. If you find a folder whose name starts with onestation there, it is safe to delete.

Keychain#

Your license key and the keys that secure phone and server connections are in the login Keychain. Delete them in Keychain Access by searching for dev.onestation, or in Terminal:

security delete-generic-password -s dev.onestation.license
security delete-generic-password -s dev.onestation.relay.v2

Run each command again until it reports that the item could not be found; there can be more than one entry of each.

onestation also keeps a tiny trial marker in the Keychain, so the free trial is once per Mac.

Notification sounds#

macOS plays notification sounds only from ~/Library/Sounds, so onestation copies its sounds there:

rm ~/Library/Sounds/onestation-*.wav

herdr and your running agents#

Uninstalling onestation never stops an agent. Agents in herdr, tmux or terminal windows keep running exactly as before; you just answer them in their own terminal again.

herdr is a separate tool and stays installed. If onestation installed it for you and you don’t want it anymore:

1. Finish or close its agents

   Type herdr in a terminal to see them, including the ones in the onestation session, and close the ones you are done with. Closing an agent ends its session.

2. Delete the program

   rm ~/.local/bin/herdr

On your phone#

After revoking the phone on your Mac, touch and hold the onestation icon on your Home Screen and choose Remove App › Delete from Home Screen. To also delete its stored keys, clear website data for onestation.dev in SettingsAppsSafariAdvancedWebsite Data (on iOS 17 and earlier: SettingsSafariAdvancedWebsite Data).

Remove a server or other Mac#

Revoke it on your Mac first (step 2). Then run these on the machine, as the same user that ran the install command. No sudo is needed.

Linux#

The node runs as the systemd user service onestation-node:

systemctl --user disable --now onestation-node.service
rm ~/.config/systemd/user/onestation-node.service
systemctl --user daemon-reload
rm -r ~/.onestation

If an administrator enabled lingering only for onestation, they can turn it off with sudo loginctl disable-linger <user>.

macOS#

The node runs as the LaunchAgent dev.onestation.node:

launchctl bootout gui/$(id -u)/dev.onestation.node
rm ~/Library/LaunchAgents/dev.onestation.node.plist
rm -r ~/.onestation

rm -r ~/.onestation/relay-node ~/.onestation/bin/onestation \
  ~/.onestation/node-service ~/.onestation/node-version ~/.onestation/node.log

Agents on the machine keep running; only the connection to your Inbox is removed.