Skip to content

mDNS integration and Web UI connection documentation (Fixes #451) #519

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wbhinton wants to merge 1 commit into
base: master
Choose a base branch
from
Open

mDNS integration and Web UI connection documentation (Fixes #451) #519

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/info/glossary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Below you can find a list of terms you might not be sure about, as well as some
- `LQ`: Link Quality, percentage of expected packets received. Our preferred method of measuring the quality of the control link
- `Lua`: Means "Moon" in Portuguese. As such, Lua is the correct way to write and not all uppercase. The ExpressLRS Lua script can be installed on a OpenTX radio, to easily alter TX parameters like Packet rate, Telemetry ratio and Output power. But also shows if the radio (OpenTX) is communicating correctly with the module. ( e.g. 0:50, 0:150, 0:200 and so on.)
- `MCU`: Micro Controller Unit, generally denotes an embedded system controller as opposed to big iron CPU
- `mDNS`: Multicast DNS. It allows for hostnames (like `elrs_rx.local` or `elrs_tx.local`) to be resolved into IP addresses on a local network without the need for a dedicated DNS server.
- `OSD`: On Screen Display, refer to [this page for instructions for setup in BF](../quick-start/pre-1stflight.md#rssi-and-link-quality)
- `OTA`: Update your device `Over The Air` (WiFi)
- `OTX`: OpenTX
Expand Down
10 changes: 10 additions & 0 deletions docs/quick-start/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -203,6 +203,16 @@ description: Stuck on your ExpressLRS setup? Let us help you with that! Here's s

To ensure that the WiFi flashing is finished properly, **wait until the LED on the receiver blinks slowly** (indicating it's looking for a TX bind) before pulling off power.

### <span class="custom-heading" data-id="24">I cannot reach http://elrs_tx.local or http://elrs_rx.local</span>

??? Note "I cannot reach http://elrs_tx.local or http://elrs_rx.local"
This is usually because mDNS is not working on your network or device.

* **Verify Connection:** Ensure your device (phone/laptop) is on the **same** WiFi network as the ExpressLRS device.
* **OS Support:** While most modern OSs support mDNS, some older versions of Windows or specific Linux configurations might not.
* **Router Settings:** Some routers block multicast traffic between wireless clients (often called "AP Isolation" or "Client Isolation"). Disable this setting if possible.
* **Use the IP Address:** If the `.local` address doesn't work, you can always use the IP address. If the device is in AP mode (hotspot), it's always `http://10.0.0.1/`. If it's on your home WiFi, check your router's DHCP list for a device named `elrs`.

If you have other questions or concerns, or maybe you need further help that is not covered by this Guide, head over to our Discord Channel or Facebook Group!

<span style="padding-left:10%; display:inline; text-align:center">[ExpressLRS Discord :fontawesome-brands-discord:](https://discord.gg/dS6ReFY){ .md-button }</span>
Expand Down
48 changes: 26 additions & 22 deletions docs/quick-start/webui.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ description: The ExpressLRS Web UI is an essential part of the ExpressLRS ecosys
![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-Hardware/master/img/quick-start.png)

## How to get to the Web UI


=== "Receivers"

1. Put your Receiver into WiFi Mode.
Expand Down Expand Up @@ -113,8 +115,9 @@ description: The ExpressLRS Web UI is an essential part of the ExpressLRS ecosys

<br clear="right" />

3. Load the Web UI on your browser using these addresses:
- http://10.0.0.1/ - If you have connected to the `ExpressLRS RX` Access Point
3. Load the Web UI on your browser. The address depends on how the Receiver is connected:

* **Access Point Mode:** If you are connected to the `ExpressLRS RX` WiFi hotspot, use [http://10.0.0.1/](http://10.0.0.1/).
Copy link
Copy Markdown
Member

@jurgelenas jurgelenas Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not correct. elrs_rx.local. and others should work even in AP mode.

In fact, in AP mode - all hostnames should be resolved to the device IP address.

Copy link
Copy Markdown
Author

@wbhinton wbhinton Apr 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will get that fixed. I did test out the AP mode and while all hostnames did resolve to the WebUI when I typed them in directly to the address bar, if there was a link I clicked, like a bookmark it did not always redirect to the WebUI. This was on Windows 11 in Chrome.

Does it work for you if I reword it stating that the AP mode should resolve any hostname, but that 10.0.0.1 can be used in case that doesn't work?


!!! Note
This IP address is also often used by some routers. Computers with an ethernet connection to their routers will find that this page doesn't load the ExpressLRS Web UI and instead loads their router or ISP modem configuration dashboards.
Expand All @@ -124,23 +127,23 @@ description: The ExpressLRS Web UI is an essential part of the ExpressLRS ecosys
!!! Note
On some devices a network login prompt might pop up. Clicking this will often show an incomplete version of the webui that won't behave as expected. Please navigate to http://10.0.0.1/ manually in your browser instead.

- http://elrs_rx.local - If you have previously set your Home WiFi SSID and Password into your Receiver when you flashed it.
* **Home WiFi Mode:** If the Receiver is connected to your local network, use [http://elrs_rx.local/](http://elrs_rx.local/).

!!! Note
If your browser cannot resolve this address, chances are MDNS is not set up and working on your computer or network.
If your browser cannot resolve this address, chances are mDNS is not set up and working on your computer or network.

??? tip "Use the IP Address instead! (click/tap to expand)"
=== "The `arp` Command"

1. Open up a Command Prompt window on your computer.
1. Open a terminal or command prompt on your computer.
2. Execute the command `arp -a` which will list all the devices in the Network.
3. Try each of the IP Addresses marked as `Dynamic` as a URL in your Browser until you get to the ExpressLRS Web UI.
3. Look for the list of dynamic IP addresses. On most networks, ExpressLRS devices will appear with a MAC address starting with `30-ae-a4`, `24-4c-6a`, or `84-f3-eb` (standard Espressif/ESP prefixes).
4. Try each of these IP addresses in your browser until you reach the ExpressLRS Web UI.

=== "Router DHCP List"
1. Log in to your Router dashboard.
2. Check the DHCP List and look for the "elrs" device.
3. Take note of the IP Address given by your router.
4. Use this IP address in your Browser as the URL.
1. Log in to your router's web interface (usually `192.168.1.1` or `192.168.0.1`).
2. Navigate to the "Attached Devices" or "DHCP Client List" section.
3. Look for a device named `elrs-rx`. If the name isn't showing up, look for a device with an "Espressif" manufacturer tag.
4. Use the IP address assigned to this device in your browser.

=== "TX Modules"

Expand Down Expand Up @@ -189,8 +192,9 @@ description: The ExpressLRS Web UI is an essential part of the ExpressLRS ecosys

<br clear="right" />

3. Load the Web UI on your browser using these addresses:
- http://10.0.0.1/ - If you have connected to the `ExpressLRS TX` Access Point
3. Load the Web UI on your browser. The address depends on how the TX Module is connected:
Copy link
Copy Markdown
Member

@jurgelenas jurgelenas Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not correct. elrs_rx.local. and others should work even in AP mode.

In fact, in AP mode - all hostnames should be resolved to the device IP address.


* **Access Point Mode:** If you are connected to the `ExpressLRS TX` WiFi hotspot, use [http://10.0.0.1/](http://10.0.0.1/).

!!! Note
This IP address is also often used by some routers. Computers with an ethernet connection to their routers will find that this page doesn't load the ExpressLRS Web UI and instead loads their router or ISP modem configuration dashboards.
Expand All @@ -200,23 +204,23 @@ description: The ExpressLRS Web UI is an essential part of the ExpressLRS ecosys
!!! Note
On some devices a network login prompt might pop up. Clicking this will often show an incomplete version of the webui that won't behave as expected. Please navigate to http://10.0.0.1/ manually in your browser instead.

- http://elrs_tx.local - If you have previously set your Home WiFi SSID and Password into your TX Module when you flashed it.
* **Home WiFi Mode:** If the TX Module is connected to your local network, use [http://elrs_tx.local/](http://elrs_tx.local/).
Copy link
Copy Markdown
Member

@jurgelenas jurgelenas Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not correct. elrs_rx.local. and others should work even in AP mode.

In fact, in AP mode - all hostnames should be resolved to the device IP address.


!!! Note
If your browser cannot resolve this address, chances are MDNS is not set up and working on your computer or network.
If your browser cannot resolve this address, chances are mDNS is not set up and working on your computer or network.

??? tip "Use the IP Address instead! (click/tap to expand)"
=== "The `arp` Command"

1. Open up a Command Prompt window on your computer.
1. Open a terminal or command prompt on your computer.
2. Execute the command `arp -a` which will list all the devices in the Network.
3. Try each of the IP Addresses marked as `Dynamic` as a URL in your Browser until you get to the ExpressLRS Web UI.
3. Look for the list of dynamic IP addresses. On most networks, ExpressLRS devices will appear with a MAC address starting with `30-ae-a4`, `24-4c-6a`, or `84-f3-eb` (standard Espressif/ESP prefixes).
4. Try each of these IP addresses in your browser until you reach the ExpressLRS Web UI.

=== "Router DHCP List"
1. Log in to your Router dashboard.
2. Check the DHCP List and look for the "elrs" device.
3. Take note of the IP Address given by your router.
4. Use this IP address in your Browser as the URL.
1. Log in to your router's web interface (usually `192.168.1.1` or `192.168.0.1`).
2. Navigate to the "Attached Devices" or "DHCP Client List" section.
3. Look for a device named `elrs-tx`. If the name isn't showing up, look for a device with an "Espressif" manufacturer tag.
4. Use the IP address assigned to this device in your browser.

## The ExpressLRS Web UI Explained

Expand Down
Loading