Troubleshooting

If you only have 2 minutes, use this page as a triage front door.

First 60 seconds

Run this exact ladder in order:

bash
mayros status
mayros status --all
mayros gateway probe
mayros gateway status
mayros doctor
mayros channels status --probe
mayros logs --follow

Good output in one line:

  • mayros status → shows configured channels and no obvious auth errors.
  • mayros status --all → full report is present and shareable.
  • mayros gateway probe → expected gateway target is reachable.
  • mayros gateway status → Runtime: running and RPC probe: ok.
  • mayros doctor → no blocking config/service errors.
  • mayros channels status --probe → channels report connected or ready.
  • mayros logs --follow → steady activity, no repeating fatal errors.

Decision tree

mermaid
flowchart TD
  A[Mayros is not working] --> B{What breaks first}
  B --> C[No replies]
  B --> D[Dashboard or Control UI will not connect]
  B --> E[Gateway will not start or service not running]
  B --> F[Channel connects but messages do not flow]
  B --> G[Cron or heartbeat did not fire or did not deliver]
  B --> H[Node is paired but camera canvas screen exec fails]
  B --> I[Browser tool fails]

  C --> C1[/No replies section/]
  D --> D1[/Control UI section/]
  E --> E1[/Gateway section/]
  F --> F1[/Channel flow section/]
  G --> G1[/Automation section/]
  H --> H1[/Node tools section/]
  I --> I1[/Browser section/]