4.2 KiB
| id | title | sidebar_label |
|---|---|---|
| web-app-software | Web interface overview | Overview |
The web interface is available for all browsers, but bluetooth and serial capabilities are limited. You can connect to your node using:
- client.meshtastic.org
- BLE
- HTTP
- Serial
- ESP32 WiFi SoftAP
- ESP32 as Client
The Meshtastic firmware incorporates an embedded web server using the ESP32 HTTPS Server project. This allows the WiFi supporting ESP32 devices to run our web interface to access Meshtastic directly from your browser. This imports the Meshtastic.js library to provide a web page capable of interacting with the device.
:::caution Please note that this is under active development and liable to change. :::
:::caution It has been reported that some of this information is out of date.
FIXME - Investigate and rewrite document to reflect the current web usage solution. :::
Configuration
The web interface is now included in firmware releases. There is active development ongoing to fix some issues with updating the web interface from the web interface directly. Please be patient with us as we work on this. Use Meshtastic-flasher to update your device to the current stable build which includes the web interface.
Wifi configuration
WiFi configuration is required to use the web interface. Any method of set up will work:
If you have just one Meshtastic device on your network, the easiest thing to do is to go to http://meshtastic.local printed on your device screen. That URL should work provided that mDNS (aka ZeroConf) is not blocked on your local network. If you have more than one device or there's a problem with mDNS name resolution, you will have to refer to the device's IP address. The IP address will also be available on the screen. It can also be found by reading the serial logs when the device boots up.
:::note The first time your device restarts after enabling WiFi, it will take an additional 20-30 seconds to boot. This is to generate self-signed SSL keys. The keys will be saved for future reuse. :::
Common Problems
Problem: File not found: /static/index.html
:::note This issue is likely found on old versions of the web interface. Device firmware now includes the web interface and the file system has been changed. Flashing the device with Meshtastic-flasher will update you to the current web interface. Access to the files in the filesystem is actively being developed, but is not currently available. :::
Cause: This most likely means that the file system for the web server has not been loaded. You probably used esphome-flasher or some other GUI tool to flash the firmware.
Solutions:
Option 1) Flash the device with the device-install.sh script that comes packaged with the firmware zip file (you'll lose previous settings). Then follow the instructions under configuration to upload the web interface.
Option 2) Flash the device with the OTA update from within the Android application.
Option 3) Flash the device with the SPIFFS instructions in platform.io.
Insufficient space to upload new files
:::note This issue is likely found on old versions of the web interface. Device firmware now includes the web interface and the file system has been changed. Flashing the device with Meshtastic-flasher will update you to the current web interface. Access to the files in the filesystem is actively being developed, but is not currently available. :::
Cause: Typically a small partition has been set aside from previous firmware installed on the module. Instructions for how to fix this can be found on the ESP32-Partitions page.