# \[App\]\[Pro\] Micro Web Server **URL:** \ **Category:** Apps\ **Tags:** app, official, tools\ **Created:** [February 29, 2020, 4:12pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565 "2020-02-29T16:12:06Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [February 29, 2020, 4:12pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/1 "2020-02-29T16:12:06Z")
# Micro Web Server This app turns your Homey into a basic WebServer for your local network. ![large](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/1/010ed82f0176037df38246534cb5fba16601e11c.jpeg) App Store: [Micro Web Server](https://homey.app/a/com.sdn.webserver) [Frequently Asked Questions](https://community.homey.app/t/homey-serves/26565/2) [Change Log](https://community.homey.app/t/homey-serves/26565/3) ## Supported Languages 🇬🇧 English đŸ‡©đŸ‡Ș German ## What? Yes, a WebServer! There are some use cases where you simply do not want to run another device just to serve a few resources by http. The app runs a WebServer locally on Homey. This WebServer is not reachable from Internet. You can use it to host basically any resource you need in reach on your local network. Like a sound file used by another app. Or a full web page even. Got your own Homey Dashboard written in html and javascript? Let it be served by home itself. ## Warning and Disclaimer Whilst you could basically make the Homey hosted WebServer public on the internet using port forwarding, I highly recommend **not** to do that. The app is not meant to serve tons of requests from random people. Also, I am not responsible for the content you are hosting with it, nor for any possible harm one could do to your Homey by abusing it. ## Getting Started To get started, go into the app settings and start the integrated ftp server. Whilst the ftp server is running you can manage the content of your Homey WebServer with basically any ftp client. ### Step 1 - Getting Ready for File Uploads First thing to do after installing is provide some content to be hosted. To get files onto the Homey we need to start the ftp server of the app. For security reasons it is not running by default. Open the settings of the app. It should look somewhat like this: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/3/e3bfcd8da41f76b950307b79be8d9714c70cbe06.png) After the ftp server is started you should see the ftp address: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/a/1a466a2272ad1d2fb38816be9acdfb9bc0251bdd.png) ### Step 2 - Connect The FTP Client Upload your files. Am using FileZilla here as it has proven to work nicely. Open FileZilla and connect using the hostname shown after ftp:// (or your Homey’s IP) for the _Host_ setting. The default port is 5081 and for login you need to use anonymous authentication: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/b/bbd8ab4f03a7835d5051b5603f0fac502411e139.png) And connect. ### Step 3 - Upload Files and Test After uploading the files you can address them by using the http address shown on the app’s settings page. Let us assume you just uploaded a giggle.mp3 file. The address would be: [http://homey-YourHomeyId:5080/giggle.mp3](http://homey-YourHomeyId:5080/giggle.mp3) ## About Directories You can create or upload directories as well. If you open a directory url in your browser instead of pointing to a dedicated file, the app will automatically look for an index.htm or index.html file. Other default index files are currently not supported. ## Available Flowcards ### Triggers > ### A WebTrigger was received > > WebTriggers are basically WebHooks which are available, by this WebServer, on your local network only. > > #### Arguements > > - ‘Respond to Trigger Name’ defines the name of the trigger to react to. > > #### Tokens > > The WebTrigger can carry up to 5 payloads which are made available as tokens to the flow being run. Each payload as 3 representations as follows: > > - ‘Trigger Data # (as text)’ > - ‘Trigger Data # (as number)’ > - ‘Trigger Data # (as boolean)’ > > In addition the trigger name is available in the flow as text value: > > - ‘Trigger Name’ > > #### Usage > > The WebTriggers are basic HTTP GET requests sent to the WebServer. > **URL Example:** [http://homey-YourHomeyId:5080/webTrigger?name=MyTrigger&data1=MyTriggerData](http://homey-YourHomeyId:5080/webTrigger?name=MyTrigger&data1=MyTriggerData) > Please note that the URL parameters are case sensitive. > The parameter ‘name’ defines the trigger name. It is the name you enter as arguement in the flowcard. The ‘data’ (data, data1, data2, data3, data4, data5) parameters are optional. The parameter ‘data’ is just an alias for ‘data1’. > ### An advanced WebTrigger was received > > WebTriggers are basically WebHooks which are available, by this WebServer, on your local network only. > > #### Arguements > > - ‘Respond to Trigger Endpoint’ defines the endpoint of the trigger to react to. The base path is ‘/webTriggerAdv/’, so you can define as many endpoint as you like. Examples: /webTriggerAdv/MyTrigger, /webTriggerAdv/MySpecialTriggers/Trigger1, .. > - ‘Optional: Respond to specific method only’: By default the trigger card responds to any request (GET, PUT, POST; DELETE, PATCH) send to your endpoint. But you can optionally limit it to listen for a specific method only. > #### Tokens > > The advanced WebTrigger provides access to following data of the request: > > - ‘Trigger Endpoint’ (text) - The endpoint name after /webTriggerAdv/. > - ‘Method’ (text) - The HTTP method used. > - ‘Request has Body’ (boolean) - Whether the request has a body data. > - ‘Request has Json Body’ (boolean) - Whether the request has a json data body available. > - ‘Json parsing error message’ (text) - This field defaults to ‘No Error’. It will hold the error message if the requests body could not be parsed to a json object. > - ‘Raw trigger payload data’ (text) - The raw data object of the trigger flowcard. You could already use this but there is an action flowcard for advanced flows which provides you with easy access to the triggers data. > #### Usage > > The WebTriggers are basic HTTP GET requests sent to the WebServer. > **URL Example:** [http://homey-YourHomeyId:5080/webTriggerAdv/aTriggerName?queryValue=something&someOtherQueryValue=somethingElse](http://homey-YourHomeyId:5080/webTriggerAdv/aTriggerName?queryValue=something&someOtherQueryValue=somethingElse) > Please note that the URL parameters are case sensitive. ### Actions > ### Get data from advanced trigger payload > > This action is available in advanced flows only and provides easy access to any data received from the webhook. > > #### Arguements > > - ‘Trigger payload token to use’: The flow token (_Raw trigger payload data_ token) provided by the trigger flowcard to be used. > - ‘Data source’: Where to look for data. This can either be the request’s header fields, the url query parameter fields or the request’s json body data. > - ‘Data Field to extract’: The name or path of the data field to extract. In case of the headers (mind that header field names often are lower case automatically) and url query fields you just use the name of the field here. For the json body you can address nested fields with the dot syntax (Example: MyObject.MyObjectValue). You can also access individual array elements using the bracket index syntax (Example: MyArray[23]). > #### Tokens > > The card emits flow tokens for the extracted field: > > - ‘Trigger Data (as text)’ > - ‘Trigger Data (as number)’ > - ‘Trigger Data (as boolean)’ > #### Usage > > Here is a very basic advanced flow example to give you a better idea of how it works: > > ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/2/d/2daf6f9caa0ce8443be3e386145effe05d808947.png) > This flow would now react to a request like this: > ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/4/4/4459e09a2b6bdf3ded08ff9e572c6346087e7735.png) ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [February 29, 2020, 4:12pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/2 "2020-02-29T16:12:21Z")
# Frequently Asked Questions > **Q:** Can it host a local copy of [homeydash.com](http://homeydash.com)? > **A:** : Yes. This has been tested successfully. > **Q:** Which FTP client should I use? > **A:** : Whilst it is supposed to work with any ftp client, some seem to cause problems. It has been tested successfully with FileZilla. > **Q:** WinSCP does not list the files on Homey? > **A:** : WinSCP was reported to be working with certain settings: > **File Protocol:** FTP > **Encryption:** No encryption > **Host name:** IP of Homey > **Port number:** 5081 > **Login:** Use “Anonymous login” > Disable “Passive mode” in advanced settings for the connection. > **Q:** The URL shown on the app settings page is not working with Chromecast? > **A:** : I am not sure why a Chromecast device would not resolve it. But try using your Homey’s LAN IP instead of the host name. This has proven to work as well. Like [http://192.168.2.55:5080/aDirectory/giggle.mp3](http://192.168.2.55:5080/aDirectory/giggle.mp3) > **Q:** My mp3 file is not playing when I cast it using the cast audio url card of the chromecast app. > **A:** This is a known issue. I do not know why Athom’s chromecast app behaves weirdly there. But it will work if you use the cast website card instead. > **Q:** The FTP Server allows anonymous access, isn’t that pretty insecure? > **A:** : I did that for ease of use. However, the ftp server is not started automatically. Simply restart the app and no one can access it anymore. > **Q:** Does it support https? > **A:** No. This is not planned to be supported either. > **Q:** Can I run php scripts and things like that? > **A:** No. The WebServer only serves static files (HTTP GET is handled only). If you need such fancy stuff you might as well consider running a full blown WebServer on your lan instead. However, starting with v1.2.2 you can send HTTP GET requests to the WebServer to trigger flows. ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [February 29, 2020, 4:12pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/3 "2020-02-29T16:12:34Z")
# Change Log > ## v2.2.0 > > - Added: Advanced webhook data retrieval flowcard now supports array access as well. > ## v2.1.1 > > - Added: Advanced webhook support. > ## v2.0.6 > > - Homey Pro 2023 compatibility update. (again 😠 ) > ## v2.0.5 > > - Fixed: WebTrigger compatibility for Homey Pro 2023. > ## v2.0.4 > > - Homey Pro 2023 compatibility update. > ## v2.0.3 > > - Fixed: Edge case crashes. > ## v2.0.2 > > - Updated: Added formatted card titles. > ## v2.0.1 > > - Updated: Advanced flows compatibility update. > ## v2.0.0 > > - Updated: Supported mime types been updated. > - Updated: The app has been migrated to Homey App SDK v3. > ## v1.5.0 > > - Updated: Supported mime types been updated. > - Added: App setting to optionally auto launch the ftp service on app startup. > ## v1.4.0 > > - Updated: Supported mime types been updated. > - Updated: FTP greeting message now includes the app version. > - Updated: Minor changes to the FTP server instancing to be more explicit on the interface to listen on. > ## v1.3.0 > > - Updated: Supported mime types been updated. > ## v1.2.3 > > - Fixed: A potential app crash issue when a certain error condition is met. > - Updated: Sent HTTP headers are now more compliant to common standards used. > ## v1.2.2 > > - Fixed: Now the WebServer returns proper HTTP status codes for unsupported request types. > - Update: Upgraded to new nodejs URL api. For compatibility reasons the new version now requires Homey firmware version 4.2.0 or higher. > - Added: Basic WebTrigger support. > ## v1.1.0 > > - Fixed: App crashed when no index.htm/index.html file was found when calling a directory. Returns now a proper HTTP 404 as you would expect. > - Fixed: App crashed when HTTP port was already in use or blocked. > - Fixed: Sending url rewrites for directories without trailing slash. > - Changed: Service startup errors (if any) are now shown on the settings page along the status of the service. > - Changed: The start ftp server command now gives feedback when triggered by hiding itself. > - Added: Proper handling of query data in URLs. > ## v1.0.1 > > - Rebranding > ## v1.0.0 > > - Initial Release ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [March 5, 2020, 10:36am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/4 "2020-03-05T10:36:19Z")
Initial version has been released to the App Store today! Enjoy. ---
**Author:** ![Rocodamelshekima](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rocodamelshekima/32/8209_2.png) [@Rocodamelshekima](https://community.homey.app/u/Rocodamelshekima)\ **Post date:** [March 5, 2020, 7:06pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/5 "2020-03-05T19:06:30Z")
Works like a charm with FileZilla. Have also tested CuteFTP but could not connect with it. Nice job, well done! ---
**Author:** ![Rocodamelshekima](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rocodamelshekima/32/8209_2.png) [@Rocodamelshekima](https://community.homey.app/u/Rocodamelshekima)\ **Post date:** [May 3, 2020, 5:38pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/6 "2020-05-03T17:38:22Z")
Question: Install app and add 100MB of files to the micro web server. Then delete app, what happens to the uploaded files? Will they stay on the server or will they be deleted? ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [May 3, 2020, 5:41pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/7 "2020-05-03T17:41:54Z")
The files are stored in an app context specific filestore. So I would assume that this storage is wiped when you explicitly uninstall the app. Anything else could be considered as a bug by Athom I guess 😃 ---
**Author:** ![PaN13k](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/pan13k/32/12381_2.png) [@PaN13k](https://community.homey.app/u/PaN13k)\ **Post date:** [June 10, 2020, 7:37pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/8 "2020-06-10T19:37:22Z")
Tried this today. Works fine on Sonos via hostname and ip address. But doesn’t work on chromecast devices (smart clock, home mini and chromecast). Tried the hostname and ip address. Error: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/2/c/2c8d88374dab1a0f5806117f3dce90a9583595ca.png) ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [June 10, 2020, 7:41pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/9 "2020-06-10T19:41:04Z")
Hi @PaN13k, What did you try exactly? Can elaborate a bit more on what you are trying to do? And which card raised this error? ---
**Author:** ![PaN13k](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/pan13k/32/12381_2.png) [@PaN13k](https://community.homey.app/u/PaN13k)\ **Post date:** [June 10, 2020, 7:44pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/10 "2020-06-10T19:44:47Z")
I tried to cast a sound url: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/c/1/c1add07a6441dddcde484af2f049d1cb3b5a682e.jpeg) ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [June 10, 2020, 7:51pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/11 "2020-06-10T19:51:13Z")
Oha, you are right @PaN13k. I used it successfully with my Home Mini but my flow is now broken as well. But it seems like this is more an issue with the Chromecast app or the Chromecast firmware there. The URL works properly still. Guess I will test this myself now and annoy Athom about it. ---
**Author:** ![PaN13k](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/pan13k/32/12381_2.png) [@PaN13k](https://community.homey.app/u/PaN13k)\ **Post date:** [June 10, 2020, 7:52pm UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/12 "2020-06-10T19:52:23Z")
Exactly. The URL also works here. Either via de Sonos speakers or directly via de browser. Thanks in advance. ---
**Author:** ![Adrian\_Rockall](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/adrian_rockall/32/13209_2.png) [@Adrian\_Rockall](https://community.homey.app/u/Adrian_Rockall)\ **Post date:** [June 11, 2020, 8:27am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/13 "2020-06-11T08:27:43Z")
> [@Shakesbeard](#): > > The files are stored in an app context specific filestore. So I would assume that this storage is wiped when you explicitly uninstall the app. Anything else could be considered as a bug by Athom I guess 😃 My situation could be completely different but this is an observation from my ONVIF app. I store the last motion event image in what I believe is an app context filestore (not the standard image area). If I remove the app and then reinstall it, the last image is still there. To make sure it is cleaned up, I delete the image in the device onDeleted() event and that seems to solve my problem. Just food for thought and I’m not saying you are wrong. A bug by Athom, really? 😉 ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [June 11, 2020, 11:55am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/14 "2020-06-11T11:55:27Z")
Thanks to @PaN13k for bringing to attention that the cast audio url of Athom’s chromecast app is not working when passing in a Homey Micro WebServer URL. I don’t know why the chromcast app started to behave wierd there recently. Anyone having this issue should replace the cast audio url card with the cast website card, giving the very same URL to the mp3. That will do the trick. ---
**Author:** ![Chris\_Peters](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/chris_peters/32/1851_2.png) [@Chris\_Peters](https://community.homey.app/u/Chris_Peters)\ **Post date:** [June 22, 2020, 9:17am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/15 "2020-06-22T09:17:28Z")
I have a problem with my FTP connection; I can log in but do not get a directory listing and cannot upload any files. I tried several FTP programs, with the following output: dos ftp command: ftp\> open 192.168.1.102 5081 Connected to 192.168.1.102. 220-Micro Web Server 220 Features: a . 530 Command requires authentication User (192.168.1.102:(none)): anonymous 230 User logged in, proceed ftp\> dir 200 The requested action has been successfully completed 425 No connection established ftp\> Filezilla: | Status: | Connecting to 192.168.1.102:5081
 | | --- | --- | | Status: | Connection established, waiting for welcome message
 | | Status: | Insecure server, it does not support FTP over TLS. | | Status: | Logged in | | Status: | Retrieving directory listing
 | | Command: | PWD | | Response: | 257 “/” | | Command: | TYPE I | | Response: | 200 Switch to “binary” transfer mode. | | Command: | PASV | | Response: | 502 Command not supported | | Command: | PORT 192,168,1,100,249,11 | | Response: | 200 The requested action has been successfully completed | | Command: | LIST | | Response: | 425 No connection established | | Error: | Failed to retrieve directory listing | I’ve been trying to find a solution but I’m running out of ideas. I would really appreciate any suggestion that you may have. ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [June 22, 2020, 9:37am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/16 "2020-06-22T09:37:15Z")
Hi @Chris_Peters, have you tried using FileZilla, yet? Also, can you please submit me a diagnostics report for the app so I can check on your logfile? In your Homey app go to More -\> Apps -\> Micro WebServer -\> Little Gear (up right on Android) -\> Submit Diagnostics report. Please include your forum name in the report message for reference. ---
**Author:** ![Chris\_Peters](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/chris_peters/32/1851_2.png) [@Chris\_Peters](https://community.homey.app/u/Chris_Peters)\ **Post date:** [June 22, 2020, 10:00am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/17 "2020-06-22T10:00:28Z")
Hi, thanks for the quick reaction. The FilleZilla log is at the bottom of my original message. I have submitted the diagnostics report; the code is: 0fc322a7-37c5-41f2-a7ee-69594bab919d Chris ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [June 22, 2020, 10:16am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/18 "2020-06-22T10:16:31Z")
Hi again @Chris_Peters, I assume the 192.168.1.100 is the system you are trying to connect from? The good news, the ftp server part seems run properly. The bad news part) The server says it is getting timeout error while trying to write the result back to the client. Do you have any special desktop firewall software in place maybe which could be interferring? ---
**Author:** ![Chris\_Peters](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/chris_peters/32/1851_2.png) [@Chris\_Peters](https://community.homey.app/u/Chris_Peters)\ **Post date:** [June 22, 2020, 10:31am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/19 "2020-06-22T10:31:10Z")
I have windows firewall, so that could be a problem. I just don’t know how to fix that ---
**Author:** ![Shakesbeard](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/shakesbeard/32/15112_2.png) [@Shakesbeard](https://community.homey.app/u/Shakesbeard)\ **Post date:** [June 22, 2020, 10:52am UTC](https://community.homey.app/t/app-pro-micro-web-server/26565/20 "2020-06-22T10:52:54Z")
@Chris_Peters hmm am also using the buildin win firewall without issues though. I will have a closer look at it after work. Let me know if you find anything in the meantime. [Next page](https://community.homey.app/t/app-pro-micro-web-server/26565.md?page=2)