Troubleshooting Guide

View source: docs/11-troubleshooting.md on GitHub

This file exists so panic does not.

Common Issues

SSH Access Lost

• Check firewall rules
• Use DigitalOcean console
• Restore SSH keys
• Revert recent changes to /etc/ssh/sshd_config if needed

Discord Messages Not Posting

• Validate webhook URL
• Test with curl
• Check network access

Operator Not Running

• Check tmux session
• Check python venv
• Inspect logs

Web Stack Not Loading

• Verify nginx running
• Check PHP-FPM status
• Confirm ports open

Permission Denied Errors

• Ensure you are operating as the bonsai user, not root (use whoami)
• Check that /bonsaios is owned by bonsai:bonsai
• Run sudo chown -R bonsai:bonsai /home/bonsai/bonsaios if unsure

Nuclear Option

If things are too broken:

1. Destroy the droplet
2. Re-run the wizard
3. Apply what you learned

Rebuilds are cheaper than debugging at scale.

← Back to Documentation