# Troubleshooting > One command diagnoses and repairs the whole chain: config, auth, tunnel, SSH, sync, daemon, and the box agent. Start here. URL: https://prized.dev/docs/troubleshooting ## Run the doctor [#run-the-doctor] ```bash prized doctor ``` It repairs as it goes (a missing `~/Prized`, Mutagen not fetched, a stopped daemon, a missing SSH `Include`, a box agent behind your CLI), marking each `(fixed)`. A passing check prints nothing, so only what failed is on screen, with its remedy. `--no-fix` reports without touching anything; `-v` prints every check; `--bundle` writes a diagnostics tarball for a bug report, and nothing leaves your machine. ## Box and daemon [#box-and-daemon] | Symptom | Try | | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Box shows unreachable | `prized ssh`: a suspended box wakes on connect. Still down? `prized box info` and the dashboard show its state and last events. | | `open terminal failed: missing or unsuitable terminal: xterm-ghostty` from `prized ssh`, or `unknown terminal type` inside a `--raw` shell (Ghostty) | The box's terminal database did not know Ghostty's `TERM`. Boxes install the entry themselves on the box agent's next refresh, within about six hours of the box running; a box created after that ships with it. Until then, `TERM=xterm-256color prized ssh ` connects. | | Cmd-C copies nothing out of Claude Code | Claude handles the mouse itself. Select and press **c** instead: through `prized ssh` the text lands on your clipboard. To select in the terminal, hold **Fn** (Apple Terminal), **Option** (iTerm2) or **Shift** while dragging, then Cmd-C ([Copy out](https://prized.dev/docs/sessions#copy-out)). | | Box paused by itself | The last event in `prized box info` says why: `reconciler:auto_pause` (idle) or `reconciler:pause_deadline`. `prized box auto-pause BOX off` and `prized box extend BOX --no-deadline` switch the rules off ([Boxes](https://prized.dev/docs/boxes#auto-pause)). A box on the [free credit](https://prized.dev/docs/billing#free-credit) is never paused by the idle rule. | | `ssh: Could not resolve hostname ` from `ssh ` or a sync session | A box's name resolves only through the SSH stanza prized writes (`~/.ssh/config.d/prized`), activated by an `Include` line at the top of `~/.ssh/config`; your ssh did not apply it. `prized doctor` says which and repairs what it can: the line missing (or a stray pre-rename `Include config.d/doppel` that names no file this install wrote — `prized doctor --fix` adds the `config.d/prized` line), a `Host`/`Match` block above it, or an ssh that resolves the box with `-F ~/.ssh/config.d/prized` but not from `~/.ssh/config` (an alias or wrapper around `ssh`, or a HOME that is not your account's). `prized setup`, `prized ssh` and `prized exec` read the stanza file directly and keep working meanwhile; `ssh ` and sync need the Include. | | `"" is not the box this machine knew by that name` (from `ssh ` or a prized command) | The alias was bound to a box that no longer wears the name: the box was recreated, or its freed name was taken by another box. If that is expected, `prized box rebind ` binds the alias to the box that wears the name now; otherwise `prized box ls` shows what is on the account. `could not verify that "" is still box …` means the check itself could not be made (signed out, or Prized unreachable): `prized login`, or try again. A `prized proxy` that was already running when the name changed hands stops with the same message; anything else still connected under that name is refused the same way until you rebind. | | Daemon not running | `prized daemon restart`, then `prized daemon logs` if it will not stay up. On a machine that has never run `prized setup` there is nothing to restart yet, and the command says so: setup installs the daemon when it connects a box (`prized daemon install` does it on its own). | | `prized setup` or `daemon install` says the daemon is installed for your login session and this terminal is not in it | You are in a shell outside your macOS login session (ssh, a terminal a remote tool opened, a shell either started), and the daemon on this Mac was installed from inside it, as a GUI-session agent that such a shell cannot see or touch. Run the same command from Terminal on the Mac itself. A machine that has never had the daemon is different: setup from an ssh or remote shell installs it as a background agent, which any login of yours brings up, and which Terminal on the Mac can manage too. | | "the running daemon serves a different box" | You switched the default with `prized init --force` while the old daemon ran, or aimed `--config` at another box's file. `prized daemon restart` moves it. | | doctor warns the daemon serves another box | `--config` drives another box with no port mirrors. Connect it with `prized setup --box NAME` and use `--box NAME` instead. | | doctor reports an unpinned SSH bridge | The stanza was written by an earlier release; `prized doctor --fix` rewrites it (so do `prized login` and `prized setup`). | | `no config for box NAME` | `--box NAME` needs a box connected on this machine: `prized setup --box NAME` does it (`prized ssh NAME` reaches a box without one). A misspelled name lands here too; `prized box ls` has the right one. | | `Connection closed by UNKNOWN port 65535` from `ssh ` or `prized ssh` | ssh's wording for the Prized bridge behind the stanza ending before it connected; the `prized _stdio:` line above it says why (signed out, the box unreachable, a name that changed hands). `prized doctor` checks the chain. | | doctor fails `agent-version` | Agent behind the CLI: `prized doctor` updates it (a brand-new box also catches up on its own within a minute or two). `cli behind the agent`: run `prized update`. | | Claude Desktop (or another SSH app) asks for a password | The box has not received this machine's device key yet. Run `prized login` (or one `prized ssh`) here, wait a minute, retry ([Claude Desktop remote](https://prized.dev/docs/claude-desktop)). | | Claude Desktop connects but its terminal reports `PTY allocation request failed` | Fully quit and reopen Claude Desktop, then reconnect to the box to refresh its terminal permissions. If it still fails, contact support ([Claude Desktop remote](https://prized.dev/docs/claude-desktop)). | ## Ports and sync [#ports-and-sync] | Symptom | Try | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | A port is not on localhost | `prized ports ls` shows every listener and why one is not mirrored. A toggled-off port stays off until you toggle it back. | | Sync seems stuck | A first edit in a folder the box has not touched recently can take 10 s. Then `prized sync ls`, `prized sync flush` to force a cycle, `prized sync repair myproject` if a session halted. | | Sync shows `error` | The reason is under the table and the daemon retries by itself. Fix the cause (or `prized sync rm` the project) and re-run `prized setup`. | | Every project is `paused` and you did not pause it | Your machine ran low on disk and Prized paused sync ([Sync](https://prized.dev/docs/sync#low-disk-on-your-machine)); the line under the table has the figure. Free space or ignore the folders that should not travel, then `prized sync resume --all`. | | `prized setup` says the project step failed, but the box is fine | Re-run `prized setup`; `prized sync ls` names the cause. | | Mutagen reported missing | `prized doctor` fetches Prized's managed copy; so does `prized mutagen ensure`. | ## CLI and updates [#cli-and-updates] | Symptom | Try | | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CLI feels outdated | It [updates itself](https://prized.dev/docs/cli#updates); `prized update` installs the newest release now. | | `prized version` warns the daemon version differs | An update landed while something was connected through the daemon; `prized daemon restart` applies it now. | | Every command exits 5 with an update hint | Your CLI is older than the minimum the API supports. Run `prized update` once. | | `prized: command not found` right after installing | `~/.local/bin` is not on this shell's `PATH` yet: `source` the file the installer's last line names, or open a new terminal. Windows: see [Windows](#windows). | | `prized: command not found` on an older install | Run `doppel update` once, or re-run the install script; either installs `prized` and keeps `doppel` as an alias. | | macOS asks again for folder access after an update | `prized update` to the latest release and approve once more; releases are signed with a stable Developer ID, so macOS remembers it. | | An environment item fails during setup but installs fine by hand | Re-run with `prized setup --env-workers 1` (one item at a time, in order) and `--verbose` ([Bring your environment](https://prized.dev/docs/environment)). | | `ssh: not found in a trusted system directory` | Prized runs the OpenSSH client from the system directories (`/usr/bin`; `System32\OpenSSH` on Windows), never one found on `PATH`. For an ssh installed elsewhere, name it: `bin = "/path/to/ssh"` under `[ssh]` in `~/.config/prized/config.toml`. | | `docker: not found in a trusted location` (or `pg_dump`, `gzip`) during the data step | The data step runs its helpers only from standard system and package-manager directories, the same places the scan looks, never from `PATH`. Install the tool there, or answer no to the data group and copy by hand. | ## Windows [#windows] | Symptom | Try | | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `prized` is not recognized right after installing | A window that was already open lacks the new `PATH` entry. Open a new terminal, or run `$env:Path = "$env:LOCALAPPDATA\Prized\bin;$env:Path"` in that one. | | `prized ssh` says ssh is missing | Turn on Windows OpenSSH under Settings, Optional features, OpenSSH Client, or `Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0` in an elevated PowerShell. | | SmartScreen or Defender warns about `prized.exe` | The binaries are not code-signed, so Explorer can show "unrecognized app" (More info, Run anyway). If Defender quarantines it, restore it, re-run the installer, and email the support address shown on https://prized.dev/docs/troubleshooting. | | The daemon is not running, or dies after logout | `prized daemon install` re-registers and starts the `PrizedDaemon` task, which runs only while you are signed in; `prized daemon logs` has its log. | | `prized daemon install` fails with an access error | A machine policy that blocks Task Scheduler for users blocks it. Run `prizedd run` in a terminal you keep open, and tell the support address shown on https://prized.dev/docs/troubleshooting. | | `prized mosh`, `mount`, or `env` refuses | Not on Windows yet ([CLI](https://prized.dev/docs/cli#windows)); `prized ssh`, sync, ports, `exec`, and `cp` cover the same ground. | ## Older installs [#older-installs] Configs that still point at `doppel.prized.dev` or `api.doppel.prized.dev` keep working; page requests redirect to `prized.dev`. ## Account [#account] | Symptom | Try | | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Sign-in fails with "unable to link account" | Your identity provider reports a different account for this address than the one Prized knows (a mailbox deleted, recreated, or reassigned). Email the support address shown on https://prized.dev/docs/troubleshooting. | | Every box paused and the dashboard says the workspace is suspended or paused | The message names the reason. On the free credit, one process holding the whole box at full CPU for over 30 minutes pauses the workspace: start a plan and wake the box. For mining, see [Not allowed](https://prized.dev/docs/limits#not-allowed). If it is a mistake, email the support address shown on https://prized.dev/docs/troubleshooting. | | A work address that had a Prized account now starts empty | Expected if the address was reassigned to you: accounts are keyed to your identity, not the mailbox, so you get a fresh one rather than the previous holder's. | ## Still stuck [#still-stuck] Email the support address shown on https://prized.dev/docs/troubleshooting with the doctor output.