Prized docs

Troubleshooting.

One command diagnoses the whole chain; config, auth, tunnel, SSH, sync, daemon, and the box agent. Start here.

Run the doctor

prized doctor --fix

doctor prints one line per check with a hint under anything that fails. --fix applies the repairs that are safe to automate, then re-runs. For a bug report, prized doctor --bundle writes a diagnostics tarball; nothing leaves your Mac.

Common cases

SymptomTry
Box shows unreachableprized status to confirm, then prized ssh: a suspended box wakes on connect. Still down? Check the box on the dashboard.
A port is not on localhostprized ports ls shows every listener and why one is not mirrored. A toggled-off port stays off until you toggle it back.
Sync seems stuckprized sync ls for the state, prized sync flush to force a cycle, prized sync repair myproject if a session halted.
Mutagen reported missingprized doctor --fix fetches Prized's managed copy of Mutagen; prized mutagen ensure does the same.
Daemon not runningprized daemon restart, then prized daemon logs if it will not stay up.
"the running daemon serves a different box"You set up a second box, or switched the default one, while the old daemon was still running. prized setup restarts it for you; prized daemon restart does it directly. Until it restarts, connections still work over a slower in-process tunnel.
doctor warns the daemon serves another boxExpected when you point the CLI at a second box's config: the daemon serves one box at a time, so commands work directly with the box you asked for. prized init --force makes it the default if you want the daemon on it.
CLI feels outdatedprized status and prized version tell you when an update exists; prized update installs it, verified.
prized: command not foundYour install predates the rename. Run doppel update once, or re-run the install script; either installs prized and keeps doppel working as an alias.
Both doppel and prized are installedExpected after updating across the rename: doppel is a symlink to prized, kept so existing scripts and launch configs never break. Use whichever you like; there is nothing to clean up.
Every command exits with code 5 and an update hintYour CLI is older than the minimum the API supports. Run prized update once and everything works again.
macOS asks again for folder access after an updateprized update to the latest release and approve once more. Releases are now signed with a stable Developer ID, so macOS remembers the grant across future updates; older unsigned builds re-prompted every time.

Still stuck

Email with the doctor output.

Something unclear or out of date?

On this page