When adding a Swidget Wi-Fi Insert or Wi-Fi Control Module, setup may fail at the final registration step, after the device has connected to your Wi-Fi network and you have named it and selected a room. The Swidget App may display a Wi-Fi connection error at this point, but the device has already joined your network successfully. In most cases this is caused by a blocked outbound network port that prevents the device from registering with the Swidget cloud, rather than a fault with the device.

Cause

After the device connects to Wi-Fi, the final step of setup registers the device with the Swidget cloud. Swidget Wi-Fi Inserts and Wi-Fi Control Modules connect to the cloud over a secure connection on port 8883, the standard port for encrypted (TLS) MQTT communication. If your network blocks outbound traffic on port 8883, the device joins Wi-Fi and receives an IP address, but it cannot register with the cloud, so setup fails at the registration step and an error is displayed.

Resolution

Allow outbound traffic on TCP port 8883 for the device on your router or firewall, then add the device again.

This setting is typically found under Firewall, Security, Outbound Rules, Port Filtering, or Application Control in your router or firewall configuration. If you are unsure how to change it, refer to your router or firewall manufacturer's documentation. On a managed or business network, please contact your network administrator.

When this applies

Port 8883 is open by default on most home routers, so this is uncommon on a standard residential network. It is most likely to occur on:

• Managed firewalls or business networks
• Dedicated IoT or guest networks with restricted outbound access
• Networks that use outbound port filtering or allow-lists

Additional checks

If the device still does not finish pairing after confirming that port 8883 is open:

• If port 8883 is open and the device still will not finish setup, it may have shipped on an older firmware build that cannot complete cloud registration. This is uncommon and usually applies to devices that sat in storage for a long time before setup. You can update the firmware over the device's own Wi-Fi hotspot by following Wi-Fi Insert Joined the Network but Stays Offline (Firmware Recovery), then add the device again. If you would like a hand or need the firmware file, contact us at support@swidget.com.
• Confirm you are connecting to a 2.4 GHz network. Swidget Wi-Fi Inserts and Modules do not support 5 GHz networks.
• Confirm the device and your mobile device are on the same network during pairing, and not on separate guest networks.
• Review the full pairing steps in Pairing a Wi-Fi Insert to the Swidget App.