Manage your installation

Check setup and update issues

Keep product setup separate from the tools and environment your agents use.

Before you start
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.

What you should have

A specific problem to resolve, with the environment and release identified.

Next: Work with agents →

Need more detail? Open the in-app Docs or browse source and contributor references ↗.