esphome-docs/esphomeyaml/components/web_server.rst

43 lines
1.6 KiB
ReStructuredText
Raw Normal View History

2018-05-13 11:37:02 +02:00
Web Server Component
====================
The ``web_server`` component creates a simple web server on the node that can be accessed
through any browser and a simple `REST API`_. Please note that enabling this component
will take up *a lot* of memory and can lead to problems, especially on the ESP8266.
To navigate to the web server in your browser, either use the IP address of the node or
use ``<node_name>.local/`` (note the trailing forward slash) via mDNS.
To conserve flash size, the CSS and JS files used on the root page to show a simple user
interface are hosted by esphomelib.com. If you want to use your own service, use the
``css_url`` and ``js_url`` options in your configuration.
.. _REST API: /web-api/index.html
2018-06-01 18:10:00 +02:00
.. figure:: /esphomeyaml/components/images/web_server.png
2018-05-13 11:37:02 +02:00
:align: center
Example web server frontend.
.. code:: yaml
# Example configuration entry
web_server:
port: 80
Configuration variables:
~~~~~~~~~~~~~~~~~~~~~~~~
2018-06-01 18:10:00 +02:00
- **port** (*Optional*, int): The port the web server should open its socket on.
- **css_url** (*Optional*, url): The URL that should be used for the CSS stylesheet. Defaults
to https://esphomelib.com/_static/webserver-v1.min.css (updates will go to ``v2``, ``v3``, etc).
- **js_url** (*Optional*, url): The URL that should be used for the JS script. Defaults
to https://esphomelib.com/_static/webserver-v1.min.js.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
See Also
--------
- :doc:`API Reference </api/core/web-server>`
2018-06-04 08:17:22 +02:00
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/web_server.rst>`__