Documentation

Troubleshooting

Common problems and how to report one.

A build failed

Open the Output panel. A failure is classified as a library problem, a code error, or a service problem. For a library problem, check the part's library in the plan. For a service problem, try again in a minute. A failed run is not charged.

The board is not detected

  • Use a data USB cable. Some cables only carry power.
  • Close other programs that hold the serial port, such as a serial monitor.
  • On Windows, install the driver for the board's USB serial chip.
  • In the browser, use Chrome or Edge. Other browsers cannot upload to a board.

Sign-in problems

Confirm your email address from the message sent when you signed up. Use Reset password on the sign-in page if you forgot the password. If a sign-in loop persists, clear site data for hardwareos.ai and try again.

Report a problem

Open an issue on GitHub or write to [email protected]. Include your operating system, the HardwareOS version (Settings, Updates), the board and parts, and the reference shown with a failed run.