Troubleshooting
Diagnose installation, runtime, model, permission, task, and deliverable errors in Raydo Desktop.
Start with the symptom you see. If a task failed after sending an email, publishing a page, or generating paid media, check the destination or provider history before retrying.
| Symptom | Where to start |
|---|---|
| The installer is blocked or Raydo will not open | Installation and launch |
| Raydo opens but tasks cannot start | Runtime and local services |
| Models are missing, authentication fails, or a limit is reached | Models and providers |
| Raydo cannot read a file, see the screen, or use a browser tab | Permissions |
| A task waits, fails, or seems to run twice | Task execution |
| Output is missing, the preview is blank, or export fails | Deliverables |
| An update fails or something breaks after relaunch | Updates and recovery |
- Keep the original conversation or workflow run. Record the Raydo version, operating system, time of failure, and first visible error.
- Try the smallest action that can reproduce the symptom with sample data. For example, use a new text-only chat to isolate the model or a sample file to isolate preview.
- Change one setting at a time, then repeat the same test.
- If the issue persists, prepare a support report. Review screenshots, logs, and bundles before sharing them.