Troubleshooting¶

Solutions for common issues with Bambuddy.

Printer Connection Issues¶

Printer Won't Connect¶

Symptoms: Printer shows as disconnected, red indicator

Solutions:

Verify LAN Mode is enabled
Check printer: Settings > Network > LAN Mode
Toggle off and on to get a fresh access code
Check IP address
Verify IP in printer network settings
Ensure IP hasn't changed (use static IP or DHCP reservation)
Verify access code
Access code changes when LAN Mode is toggled
Copy the code exactly (case-sensitive)
Check network connectivity
```
ping YOUR_PRINTER_IP
```
Verify ports are accessible
MQTT: Port 8883
FTPS: Port 990

telnet YOUR_PRINTER_IP 8883

Check firewall rules
Ensure Bambuddy server can reach printer
Check both server and network firewalls

Connection Drops Frequently¶

Symptoms: Printer connects but disconnects intermittently

Solutions:

Check WiFi signal strength
View signal strength on printer card
Move printer closer to router if weak
Network congestion
Too many devices on network
Try a dedicated network/VLAN
Router issues
Restart router
Check for firmware updates
Disable "smart" features that may interfere
Check Bambuddy logs
```
tail -f logs/bambuddy.log
```

Wrong Printer Status¶

Symptoms: Status shows idle when printing, or vice versa

Solutions:

Wait for sync
Status updates every few seconds
Refresh the page
Check MQTT debug
Enable MQTT debug logging
Verify messages are being received
Restart connection
Delete printer from Bambuddy
Re-add with correct details

Archiving Issues¶

Prints Not Being Archived¶

Symptoms: Prints complete but don't appear in archives

Solutions:

Check printer connection
Must be connected during and after print
Verify green connection indicator
Check FTP access
Port 990 must be accessible
Try downloading a file manually
Check disk space
Ensure enough space for 3MF files
Clear old files if needed

Check logs for errors

grep -i "archive\|error" logs/bambuddy.log

Duplicate Archives¶

Symptoms: Same print appears multiple times

Solutions:

Enable duplicate detection
Go to Settings > General
Enable duplicate detection
Clean up duplicates
Filter archives by name
Delete unwanted duplicates

Missing Thumbnails¶

Symptoms: Archive cards show placeholder instead of thumbnail

Solutions:

Check 3MF file
Some files don't include thumbnails
Re-slice with thumbnail enabled
Regenerate thumbnails
Bambuddy can regenerate from 3MF
Check Settings > Maintenance

Camera Issues¶

Camera Won't Stream¶

Symptoms: Camera page shows error or black screen

Solutions:

Check ffmpeg installation
```
ffmpeg -version
```

Install if missing:

# Ubuntu/Debian
sudo apt install ffmpeg

# macOS
brew install ffmpeg

Verify camera is enabled
Check printer settings
Camera must be enabled in LAN Mode settings
Check connection
Camera requires active printer connection
Verify printer shows as connected
Try snapshot mode
Click "Snapshot" instead of "Live"
May work when streaming doesn't

Stream Freezes¶

Symptoms: Video starts but freezes

Solutions:

Network bandwidth
Lower FPS setting
Check network congestion
Check ffmpeg processes
```
ps aux | grep ffmpeg
```

Kill orphaned processes:

killall ffmpeg

Refresh the stream
Click refresh button
Close and reopen camera page

Notification Issues¶

Notifications Not Sending¶

Symptoms: No notifications received

Solutions:

Test the provider
Go to Settings > Notifications
Click "Send Test"
Check for errors
Verify configuration
Double-check API keys/tokens
Verify phone numbers include country code
Check quiet hours
Notifications suppressed during quiet hours
Verify current time vs quiet hours setting
Check event triggers
Ensure desired events are enabled
Check printer filter settings

Notification Variables Empty¶

Symptoms: Messages show "Unknown" or blank for variables

Solutions:

Update to latest version
Variable handling improved in recent versions
Check print data
Some variables require specific print data
May show "Unknown" for incomplete prints

Database Issues¶

Database Errors¶

Symptoms: 500 errors, data not saving

Solutions:

Check disk space
```
df -h
```

Verify database integrity

sqlite3 bambuddy.db "PRAGMA integrity_check;"

Restore from backup
If corrupted, restore from backup
See Backup & Restore guide

Search Not Working¶

Symptoms: Search returns no results or wrong results

Solutions:

Rebuild FTS index
Go to Settings > System Info
Click "Rebuild Search Index"
Check search syntax
Use quotes for exact phrases
Check for typos

Smart Plug Issues¶

Plug Not Responding¶

Symptoms: Can't control smart plug

Solutions:

Verify IP address
Check plug still has same IP
Use static IP or DHCP reservation
Test Tasmota interface
Open http://PLUG_IP in browser
Verify Tasmota web interface loads

Check network access

curl "http://PLUG_IP/cm?cmnd=Status%200"

Auto Power-Off Not Working¶

Symptoms: Printer doesn't turn off after print

Solutions:

Check feature is enabled
Settings > Smart Plugs > Auto Power Off
Verify cooldown settings
Check temperature threshold
Check cooldown time
Check for queued prints
Won't power off if more prints queued

General Issues¶

Bambuddy Won't Start¶

Solutions:

Check Python version
```
python3 --version  # Need 3.10+
```
Check dependencies
```
pip install -r requirements.txt
```
Check port availability
```
lsof -i :8000
```
Check logs
```
cat logs/bambuddy.log
```

Slow Performance¶

Solutions:

Check system resources
```
htop
```
Vacuum database
Settings > System Info > Vacuum Database
Clear old logs
Logs rotate automatically
Delete very old log files if needed
Check for runaway processes
```
ps aux | grep -E "ffmpeg|python"
```

Getting More Help¶

Information to Gather¶

When reporting issues, include:

Bambuddy version - Settings > About
Printer model - X1C, P1S, etc.
Operating system - Linux, macOS, Windows
Installation method - Docker, manual
Steps to reproduce - What you did
Error messages - Exact text
Logs - Relevant log entries

Where to Get Help¶

Debugging Mode¶

Enable debug logging for more details:

# In .env file
DEBUG=true

# Or environment variable
DEBUG=true uvicorn backend.app.main:app --host 0.0.0.0 --port 8000