Development documentation may include features that are not in the latest release. Read the Lawn 0.8.1 guide.
lawn doctor
Diagnose problems
Use lawn doctor when an app is not opening or Lawn reports that something needs attention.
lawn doctor
By default, Lawn reports its version, running app count, and local network permission. For running apps, it reports the latest stored health-check results and observed port conflicts. It does not run fresh app health checks, and an app can have zero reported checks.
To check a running app's local address, pass its name or ID:
lawn doctor <instance>
When connected to Lawn on this Mac, selecting a running app also runs fresh checks of its web page and local address. These local-address checks are skipped when the CLI uses --server or LAWN_SERVER.
| Option | Description |
|---|---|
--verbose | Show more detailed output |
--output json | Show check results, available ports, and port conflicts as JSON |
# Show Lawn status and stored results for running apps
lawn doctor
# Show one running app's stored results and check its local address
lawn doctor whoami
# Show more detailed output for one app
lawn doctor whoami --verbose
The normal output is written for quick troubleshooting. Use --verbose when you need more detailed diagnostic output.