Question 1

How to install MicroWebSrv on an ESP32?

Accepted Answer

Copy the three core files (microWebSrv.py, microWebSocket.py, microWebTemplate.py) to your device's flash, typically in /flash/www, then import and start the server with mws.Start(threaded=True) as shown in the basic example. Ensure MicroPython is properly set up on the ESP32 first.

Question 2

MicroWebSrv vs MicroWebSrv2: which is better?

Accepted Answer

MicroWebSrv2 is the newer version with enhanced features and likely better maintenance. For new projects, consider MicroWebSrv2, but MicroWebSrv remains useful for simpler, compatible setups on older MicroPython environments.

Question 3

Does MicroWebSrv support JSON APIs?

Accepted Answer

Yes, it handles JSON payloads via methods like httpClient.ReadRequestContentAsJSON() and httpResponse.WriteResponseJSONOk(), making it suitable for building REST APIs directly on microcontrollers, as demonstrated in the route handlers.

Question 4

How to create a captive portal with MicroWebSrv?

Accepted Answer

Use mws.SetNotFoundPageUrl() to redirect unmatched requests to your device's IP or domain, and integrate with a DNS server like MicroDNSSrv to intercept all queries for seamless Wi-Fi configuration portals.

Question 5

What are the limitations of .pyhtml templating?

Accepted Answer

.pyhtml files allow embedded MicroPython code but have a simple syntax with limited control structures (like if, for loops). They rely on the microWebTemplate.py module and may not support advanced templating features found in full web frameworks.

Question 6

Can MicroWebSrv handle file uploads?

Accepted Answer

The README shows support for reading posted form data via httpClient.ReadRequestPostedFormData(), which can handle file uploads in multipart forms, but it's basic and may require manual processing due to microcontroller memory limits.

MicroWebSrv

What is MicroWebSrv?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions