Check setup and update issues
Keep product setup separate from the tools and environment your agents use.
The platform, release channel and exact error or unexpected behavior.
01 · Check the agent CLI first
Confirm Claude Code and Codex can sign in and work on the host using the accounts you intend to use. Existing subscriptions and provider limits still apply.
02 · Check the installation path
On macOS, save Settings, choose Start Server and allow background operation if asked; then use Open Dispatch from the menu bar. On Linux, PostgreSQL 14+ and a working systemd user session are required.
03 · Set up Mac browser trust
If the browser warns about the local HTTPS certificate, open native Settings → Network → HTTPS Certificate Trust. Export the CA certificate, add it to your login keychain in Keychain Access and set its SSL trust to Always Trust. Use the certificate from your own Dispatch installation.
04 · Check the release channel
Stable and Preview are different choices. Confirm a feature is in the release you installed before treating its absence as a setup fault.
05 · Check remote access explicitly
Another device needs a reachable host and the correct binding/trust setup. A localhost link on one machine is not automatically reachable from another.
A specific problem to resolve, with the environment and release identified.
Need more detail? Open the in-app Docs or browse source and contributor references ↗.