Find the cause. Get back to work.
Step-by-step troubleshooting for pyCANdo services, projects, connections, and updates. Each guide has a permanent link you can open directly from the dashboard.
Guides by problem
6 guides
A service is reported as “Not healthy”
Use the diagnosis details, service status, and recent logs to find out why a pyCANdo component is unavailable.
Read guideThe dashboard cannot connect to the device
Check the device address, browser certificate trust, web server, and dashboard API in a useful order.
Read guideA project runtime will not start
Find configuration, Python environment, dependency, and CAN-channel errors behind a failed project start.
Read guideA CAN interface or channel is unavailable
Check whether the configured CAN channel exists, is up, and matches the connected hardware.
Read guideAn installation or software update failed
Use pcdup diagnostics and durable logs to identify registration, download, verification, and install failures.
Read guideA certificate warning appears after a hostname change
Reissue the device certificate, regenerate the web configuration, and trust the pyCANdo certificate chain.
Read guideFrequently asked questions
Good defaults for diagnosing a problem and sharing useful information.
Where should I start when the health monitor reports a problem?
Open Diagnosis settings for the affected service, record its exact name and message, then follow the linked article. Preserve the first error before restarting anything.
Is it safe to restart an unhealthy service?
A restart can restore a transient service, but first record its status and recent logs. Repeated restarts can hide the original cause and will not correct invalid configuration or unavailable hardware.
What information should I include when asking for help?
Include the device and software version, the exact error and time, what changed beforehand, and the relevant status and log output. Remove passwords, activation keys, and other credentials.
Can the dashboard link directly to a specific article?
Yes. Every article has a permanent URL. The generic unhealthy-service destination is https://pycando.com/help/service-not-healthy/ and its section anchors can link directly to diagnosis, status, or logs.