DisplayHUB Encoder — Wi-Fi Setup & Troubleshooting

How to configure wireless networking on your DisplayHUB encoder, and how to fix the most common Wi-Fi issues.

Should I Use Wi-Fi or Ethernet?

Ethernet is always recommended. A wired connection gives you the lowest latency, highest reliability, and eliminates variables that can cause stream instability — especially in larger deployments with many encoders.

Wi-Fi can work well in smaller deployments or in locations where running a cable isn’t practical, but keep these limitations in mind:

  • Wi-Fi is a shared medium — other devices on the same network compete for bandwidth.
  • Signal strength can vary due to interference, walls, or distance from the access point.
  • Wi-Fi connections can drop briefly when the encoder roams between access points.
  • Higher-bitrate streams (above 4000 kbps) are more likely to stutter over Wi-Fi.

If you must use Wi-Fi, use a 5 GHz network when possible, keep the encoder within clear line of sight of the access point, and lower your video bitrate to reduce the risk of congestion.

Quick Tips

  • ✅ Use 5 GHz over 2.4 GHz
  • ✅ Keep encoder close to the access point
  • ✅ Use Ethernet in deployments with 3+ encoders
  • ✅ Set bitrate to 4000 kbps or lower on Wi-Fi
  • ❌ Avoid public or shared Wi-Fi networks
  • ❌ Avoid networks with many connected devices

How to Configure Wi-Fi on Your Encoder

⚠️ Important — Read Before You Apply: Switching Wi-Fi networks will change the encoder’s IP address. After the encoder reconnects you must go to the DisplayHUB Controller, delete this encoder from the encoder list, and refresh the encoder list to force the Controller to rescan and rediscover the encoder at its new address. If you skip this step the encoder will appear offline in the Controller even though it is working correctly.

Step 1 — Open the Wi-Fi Section

In the encoder dashboard, scroll down to the Wi-Fi section and expand it using the arrow on the right.

Step 2 — Select or Enter Your Network

Click Scan to see nearby networks and click a name to fill in the SSID automatically. Or type the exact network name manually — it is case-sensitive.

Step 3 — Enter Password and Apply

Enter your Wi-Fi password and click Apply Wi-Fi Settings. Once the encoder reconnects, go to the Controller, delete this encoder, and refresh the encoder list so the Controller rediscovers it.

Common Issues & Fixes

❌ Wi-Fi settings appear to apply but the network doesn’t change

This usually means one of the following:

  • Wrong password — Double-check the password carefully. Wi-Fi passwords are case-sensitive and special characters must match exactly.
  • Network out of range — The encoder can see the SSID in a scan but the signal is too weak to connect reliably. Move the encoder closer to the access point and try again.
  • Hidden SSID — If your network does not broadcast its name, the encoder may not be able to connect through the standard scan-and-connect flow. Temporarily enable SSID broadcast on your router during setup, then disable it again after connecting.

❌ The page disconnects after applying Wi-Fi and never comes back

This is expected if your computer or phone is on a different network than the one you just switched the encoder to. The encoder is now on the new network and your browser can no longer reach its old IP address.

To get back to the encoder dashboard:

  1. Connect your device to the same Wi-Fi network the encoder just joined.
  2. In your browser, go to http://displayhub-XXXXXXXX.local — replace XXXXXXXX with your encoder’s short ID, which is printed on the device label. The mDNS hostname stays the same regardless of which network the encoder is on.
  3. Alternatively, log into your router and look at the connected device list to find the encoder’s new IP address.

If the encoder did not successfully join the new network (wrong password, for example), it will fall back to its previous connection within about a minute. Reconnect your device to the original network and try again.

⚠️ Don’t forget the Controller: Once the encoder is back online, go to the DisplayHUB Controller, delete this encoder from the encoder list, and refresh the encoder list. This forces the Controller to rescan and rediscover the encoder at its new IP address. Without this step the encoder will appear offline in the Controller even though it is streaming correctly.

❌ Scan returns no networks

If clicking Scan shows no nearby networks:

  • Wait 15–20 seconds and try scanning again. The first scan after the encoder boots can return an empty list while the Wi-Fi radio finishes initializing.
  • Make sure no metal enclosure or obstruction is blocking the encoder’s onboard Wi-Fi antenna.
  • If networks still do not appear, try rebooting the encoder from the Advanced Settings panel and scanning again after it restarts.

Frequently Asked Questions

After changing Wi-Fi the encoder shows as offline in the Controller — what do I do?

This is expected. When the encoder moves to a new network its IP address changes and the Controller loses track of it. To fix it:

  1. Go to your DisplayHUB Controller dashboard.
  2. Find this encoder in the encoder list and delete it.
  3. Refresh the encoder list — the Controller will rescan and rediscover the encoder at its new address.

Can I switch back to Ethernet after setting up Wi-Fi?

Yes. Simply plug in an Ethernet cable. The encoder will prefer the wired connection automatically — no configuration change is needed. If the IP address changes, remember to delete and re-add the encoder in the Controller.

Can I use a network with a login page (captive portal)?

No. Captive portal networks — common in hotels and coffee shops — require a browser-based login that the encoder cannot perform. The encoder must be on a standard WPA2-secured or open network with direct internet access.

Does changing Wi-Fi affect my stream settings or configuration?

No. Wi-Fi is configured at the network level and is completely separate from your stream quality settings, overlays, and device settings. All encoder configuration is preserved when you switch networks.

Will the encoder remember the Wi-Fi network after a reboot?

Yes. When Wi-Fi settings are applied successfully the credentials are saved and synced to the boot partition so the encoder reconnects automatically on every restart.

What Wi-Fi security standards are supported?

The encoder supports WPA2-PSK (the most common home and business standard) and open networks. Enterprise networks using WPA2-Enterprise (802.1X / RADIUS) are not currently supported through the dashboard — contact support if you need enterprise Wi-Fi.