Skip to content

Troubleshooting

Common Issues

  • Connection Refused: Check broker host/port, firewall, and broker status
  • Authentication Failed: Verify MQTT username/password
  • SSL/TLS Errors: Check certificates and port (usually 8883)
  • Permission Denied: Add user to docker group: sudo usermod -aG docker $USER
  • Missing Env Vars: Ensure MASTER_PASSWORD_FROM_SHELL is set
  • Logs: Check /var/log/auto-deploy.log and container logs

More Help

  • See code comments in the repository for further troubleshooting details.