Skip to main content

Search

Help Center

Troubleshooting Offline Devices and Non-Responsive Hardware

Context:

If your ButterflyMX intercom, keypad, or controller is showing as offline or not responding to door codes, this guide will help you diagnose and resolve the issue. Most connectivity problems can be resolved by checking power, network connections, and device status.

Quick Diagnostics Checklist

Before diving into detailed troubleshooting, verify these basics:

  • ✅ Device has power (check LED indicators)
  • ✅ Network cable is securely connected
  • ✅ Device appears online in the ButterflyMX OS
  • ✅ Door codes are correctly entered in the ButterflyMX OS

Understanding Device Status in the ButterflyMX OS

To check if your device is online:

  1. Log in to the ButterflyMX OS
  2. Navigate to Devices in the left sidebar
  3. Locate your device in the list
  4. Check the status indicator:
    • 🟢 Green dot = Device is online and functioning
    • 🔴 Red dot = Device is offline
    • 🟡 Yellow dot = Device has a connectivity warning

Troubleshooting Controllers Showing Offline

Step 1: Verify Power Connection

Controllers require consistent power to maintain connectivity:

  1. Check that the power supply is plugged in and the outlet is working
  2. Look for LED indicators on the controller - they should be lit
  3. If no lights are visible, try a different power outlet
  4. Verify the power adapter is the correct ButterflyMX-provided unit

Step 2: Check Network Connection

Controllers need a stable network connection:

  1. Verify the Ethernet cable is securely connected to both the controller and network switch/router
  2. Check for any visible damage to the cable
  3. Try a different Ethernet cable if available
  4. Confirm the network port is active (check switch LED indicators)
  5. Verify the controller has a valid IP address in your network

Step 3: Restart the Controller

A simple restart often resolves connectivity issues:

  1. Unplug the power adapter from the controller
  2. Wait 30 seconds
  3. Reconnect the power adapter
  4. Allow 2-3 minutes for the controller to fully boot and reconnect
  5. Check the device status in the ButterflyMX OS

Troubleshooting Keypads Not Lighting Up or Responding

ACS Keypads

For ACS keypads (current generation, no camera):

  1. Check Power: Verify the keypad is receiving power from the controller
  2. Verify Wiring: Ensure all connections between the keypad and controller are secure
  3. Test the Controller: If the controller is offline, the keypad won't function - resolve controller issues first
  4. Check Configuration: In the ButterflyMX OS, verify the keypad is properly assigned to the correct door

Smart Keypads (Legacy)

For smart keypads with cameras (V1 keypads):

  1. Power Cycle: Disconnect and reconnect power to the keypad
  2. Network Check: Verify the keypad has network connectivity (check Ethernet connection)
  3. LED Indicators: Look for status lights on the keypad - no lights may indicate a power issue
  4. Factory Reset: If unresponsive, you may need to perform a factory reset (contact support for guidance)

Network-Related Issues

Common Network Problems

ButterflyMX devices require specific network conditions:

  • Firewall Rules: Ensure your network allows outbound connections to ButterflyMX servers
  • VLAN Configuration: If using VLANs, verify the device VLAN has internet access
  • DHCP: Confirm DHCP is providing IP addresses to devices
  • Bandwidth: Ensure adequate bandwidth for video streaming (minimum 2 Mbps upload per device)

Required Network Ports

ButterflyMX devices need these ports open:

  • Port 443 (HTTPS) - outbound
  • Port 5060-5061 (SIP) - outbound
  • Port 10000-20000 (RTP) - outbound

When to Contact Support

Contact the Support team by submitting a request here if:

  • Device remains offline after trying all troubleshooting steps
  • Multiple devices at the same property are offline
  • You suspect a hardware failure
  • Network configuration assistance is needed
  • The issue persists for more than 24 hours

When contacting support, please provide:

  • Property name and address
  • Device type (intercom, keypad, controller)
  • Device serial number (found on the device label or in the ButterflyMX OS)
  • When the issue started
  • Troubleshooting steps already attempted
  • Screenshots of device status from the ButterflyMX OS

Preventive Maintenance Tips

Reduce the likelihood of device issues:

  • 🔌 Use surge protectors for all ButterflyMX devices
  • 🌐 Regularly monitor device status in the ButterflyMX OS
  • 🔧 Schedule periodic checks of physical connections
  • 📊 Review network performance and bandwidth usage
  • 🔄 Keep firmware up to date (automatic updates enabled by default)

Related to