Troubleshoot an issue
A short checklist to find your next step.
A .test domain will not open
- Keep Yard open and confirm the project appears in Applications.
- Check the selected runtime is installed.
- Open Project health → Check.
yard status
yard site:doctor my-project
--live makes a limited local-server request. An occupied port may serve another app; verify the response before changing settings.
A 502 error
Check PHP-FPM, the JavaScript server, or Sail containers and their logs. Yard recovers some startup failures and displays details on its error page. Install any missing pinned runtime.
Unexpected data or interactive commands
Check the selected service, database, and .env before restoring a backup. Workspaces and isolation have different scopes. Studio’s command panel is non-interactive: use an external terminal for passwords, prompts, or REPLs.
An unresponsive model
Check credentials, quota, and provider availability. Appearing in a catalog does not guarantee access. A provider failure does not by itself indicate a Yard license issue.
For support, include macOS and Yard versions, the action, and the error. Review attached logs and images; omit keys, tokens, private certificates, and .env contents.