Troubleshooting
Find solutions to common Moltbot problems and error messages.
Troubleshooting
Having issues with Moltbot? Find solutions to common problems below.
Quick Diagnosis
Before diving into specific issues, try these quick checks:
# Check if Moltbot is running
docker ps | grep moltbot
# View recent logs
docker logs --tail 50 moltbot
# Check environment variables are loaded
docker exec moltbot env | grep -E "(API_KEY|TOKEN)"Common Issues
Port Already in Use
Error: address already in use
Webhook Not Firing
Bot doesn't respond to messages
Permission Denied
Access denied errors
Environment Variables Not Loaded
Missing or undefined config
Reverse Proxy 404
Nginx/Caddy returns 404
Telegram Bot No Response
Telegram bot doesn't reply
Getting Help
If you can't find a solution here:
- Search existing issues on GitHub
- Check the logs - most errors have clear messages
- Ask the community on Discord
- Open an issue with logs and reproduction steps
Related
- Security Checklist - Security-related troubleshooting
- Setup Guides - Installation instructions