First identify which connection failed: phone to web interface, camera stream, network to host, or host to printer. They can fail independently.
COLLECT EVIDENCE BEFORE CHANGING THINGS
1. Record the exact time, timezone, job state, and error. Compare the printer screen with OctoPrint's own status.
2. Check whether the host's web page still opens from another device. A dropped camera view or sleeping phone screen is not proof that the serial print connection disconnected.
3. Preserve relevant logs through OctoPrint's settings. Redact credentials and private information before sharing excerpts; keep the originals privately.
4. Note host power warnings, sleep/restart/update events, USB reconnect messages, and the last plugin or cable change.
5. During an active job, collect read-only observations. Wait until idle before restarting the host, moving connections, disabling plugins, or changing power arrangements.
TEST ONE CHANGE AT A TIME WHILE IDLE
Try a known-good USB data cable with secure routing. Check the host's documented supply requirements and cooling. Review sleep behavior on a reused computer. Compare a basic setup before adding camera load or third-party plugins. Use the documented safe-mode workflow when investigating plugins; it is not a repair for a loose connector or bad supply.
Do not modify USB power wiring or defeat protection because a forum comment suggested it. Follow the printer/host manufacturer's guidance for their electrical connection.
Download disconnect investigation kit (ZIP)
Download release checksums (JSON)
Includes an incident log and checklist. It contains no restart scripts or printer-control commands. Share the sequence of events, host/printer versions, connection type, and redacted log text.
References: OctoPrint logging tools, plugin troubleshooting, and our host-hardware guide.
HOMEBREW / 3D PRINTING CONVERSATIONS
OctoPrint disconnects during printing: USB, power, sleep, and logs
Practical 3D printing help, settings, projects, and advice from fellow makers.
Print troubleshooting