Troubleshooting

An agent doesn’t show up#

• Check it is one of the supported agents and actually running. New agents appear within seconds.
• An agent on another machine only shows up while that machine is Online in SettingsMachines.
• The colored chips under SettingsMachines show each source onestation watches. A red dot means that source has a problem; hover it for details.
• It shows up but you can’t answer it? It runs in a plain terminal and is watch only. Move it into herdr or start it in tmux.

An answer didn’t arrive#

• Did you press Esc within two seconds? Then it was taken back on purpose.
• Check the card’s delivery status. Failed usually means the question changed, for example because you answered it in the terminal. onestation won’t type into a different prompt. Look at the agent and answer again.
• After the trial ends without a license, answering is paused. See License.

The double-tap ⌥ shortcut does nothing#

Turn on onestation in System SettingsPrivacy & SecurityAccessibility, then quit and reopen it. If it is already on, remove it with – and add it again.

The phone says “Mac offline”#

• Your Mac must be awake, online and running onestation.
• You need an active trial or license. After activating a license, quit and reopen onestation once.
• If you revoked the phone or cleared Safari’s website data, pair it again.

A server or other Mac is offline#

Check the service and its log, and that the machine can reach relay.onestation.dev on port 443. Step by step in Machines & servers.

Permissions reset after an update#

macOS ties permissions to the app. If one stops working after an update or after moving the app:

1. Make sure onestation runs from the Applications folder.
2. In System SettingsPrivacy & Security, open the affected list (Accessibility or Screen Recording), remove onestation with – and add it again.
3. Quit and reopen onestation.

Export diagnostics#

1. Export

   Choose Help › Export Diagnostics… from the menu, or click Export… next to Diagnostics in onestationSettings… (⌘,)Troubleshooting.

2. Find the file

   A file named onestation-diagnostics-DATE-….zip appears on your Desktop.

3. Email it to us

   Attach it to an email to hello@onestation.dev with what happened and when.

The file contains app and macOS versions, settings and log event counts. Log text, agent content, paths, credentials and identifiers are removed. The full log is at ~/.onestation/hub.log; Show in Finder under Settings… (⌘,)TroubleshootingLogs opens it. Never post your license key publicly.