https://github.com/lionello/nodemcu-httpd
Small (single file) HTTP daemon for NodeMCU
https://github.com/lionello/nodemcu-httpd
http-server nodemcu webserver
Last synced: 21 days ago
JSON representation
Small (single file) HTTP daemon for NodeMCU
- Host: GitHub
- URL: https://github.com/lionello/nodemcu-httpd
- Owner: lionello
- License: mit
- Created: 2015-10-07T02:55:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-07-27T02:18:30.000Z (10 months ago)
- Last Synced: 2025-04-20T17:40:40.358Z (about 1 month ago)
- Topics: http-server, nodemcu, webserver
- Language: Lua
- Homepage:
- Size: 134 KB
- Stars: 6
- Watchers: 2
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Small HTTP server for NodeMCU
This small webserver supports the following HTTP verbs/methods:
* GET returns the contents of a file in flash
* PUT creates a new file in flash
* DELETE remove the file from flash
* POST executes the given lua script (may return a function that receives the payload)
* OPTIONS returns minimal CORS headers allowing POST from any origin
## Installation
Clone the project and edit the Wi-Fi settings in `init.lua`. You can use the shell script `up` or execute the following:
```
$ python nodemcu-uploader/nodemcu-uploader.py upload init.lua httpserver.lua
```
This assumes you've cloned the `nodemcu-uploader` project (use `--recursive`) as well, which is added as a submodule:
```
$ git submodule init
$ git submodule update
```
After uploading, connect the serial console (`screen /dev/ttyUSB0 9600` under most *nix flavors) and reboot the device. The device will print its IP address in the console.
## Usage
Once those files have been uploaded you can manage your device with `curl`, for example to PUT new files on flash:
```
curl --upload-file example.lua http://serial.console.shows.ip/
```
To reboot your device (for example after uploading a new `init.lua` or `httpserver.lua`) use `curl` to POST anything to `/`:
```
curl --data anything http://serial.console.shows.ip/
```
## TODO
* Need a way to return flash contents/listing vs. `index.html`