Troubleshooting: Common Issues and Solutions

[admin]

A collection of frequently reported issues and their solutions.

Printer Shows as Offline

Cause: Network connectivity or Developer Mode not enabled.

Fix:

1. Verify Developer Mode is enabled on the printer
2. Confirm the printer and Bambuddy are on the same network/VLAN
3. Check the IP address in Settings > Printers
4. Restart the printer if it was recently updated

Camera Not Showing Preview

Cause: Camera stream not accessible or blocked.

Fix:

1. Make sure the camera is enabled in your printer's settings
2. Check that port 6000 (RTSP) is not blocked by a firewall
3. For X1C/P1S: camera works over LAN only with Developer Mode
4. Try refreshing the browser or clearing cache

Print Won't Start from Queue/Archive

Cause: Filament mismatch, printer busy, or file transfer issue.

Fix:

1. Check that the printer has the required filaments loaded
2. Make sure the printer isn't already printing or in error state
3. Check the queue status — it might be in "Queue Only" mode
4. Verify the 3MF file isn't corrupted (try downloading and opening in slicer)

Large File Upload Fails

Cause: Timeout or proxy configuration.

Fix:

1. If using a reverse proxy, increase client_max_body_size and timeouts
2. For direct access, check available disk space
3. Try a wired connection instead of WiFi

AMS Mapping Shows Wrong Colors

Cause: AMS slot configuration out of sync.

Fix:

1. Go to the Printers page and click on the AMS slots to refresh
2. Try the RFID re-read button for affected slots
3. Ensure spools are properly assigned in the Spool Inventory

Docker on Windows: Network Issues

Cause: Docker Desktop doesn't support host networking.

Fix:

1. Enter your printer's IP address manually in Bambuddy settings
2. Don't rely on auto-discovery (SSDP) — it won't work through Docker Desktop's NAT

---

Still stuck? Create a new topic in the Help category with:

• Your Bambuddy version
• Printer model
• A Support Package