Troubleshooting

If devices fail to sync, enroll, or receive policy updates, follow these troubleshooting steps:

  1. Check the WebUI Health Check Dashboard.
  2. Verify that the ChromeOS MDM Server and Plugin are reporting a Green (Ready) status. Click on any warnings or errors for detailed diagnostic messages.
  3. Verify Connectivity and API Access. Ensure outbound TCP 443 access to Google APIs is open. Confirm that domain-wide delegation and service account JSON credentials are properly configured.
  4. Review Event Logging and Pub/Sub Alerts.
  5. If alert events are not reaching the service, publish a test message to the configured Google Pub/Sub topic and check the Google Cloud Log Router sink to ensure audit/admin events are routing correctly.
  6. Confirm Enrollment Prerequisites.
  7. Ensure the device was factory-reset (Powerwashed) before enrollment, is connected to the internet, and assigned to the correct domain. Note that personal Google accounts cannot be used for enterprise enrollment.