Upstream/esphome-docs
1
0
Fork 0
mirror of https://github.com/esphome/esphome-docs.git synced 2024-12-26 17:27:47 +01:00
Code Issues Projects Releases Wiki Activity

Add docs for keep_user_credentials (#2301)

Browse Source
This commit is contained in:
Kuba Szczodrzyński 2022-10-13 21:58:46 +02:00 committed by GitHub
parent 44689b9d69
commit 4237b1dd31
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 12 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
components/captive_portal.rst
View File

@ -16,7 +16,7 @@ After 1 minute of unsuccessful WiFi connection attempts, the ESP will start a Wi
:width: 70.0%
In this web interface, you can manually override the WiFi settings of the device (please note
this will be overwritten by any subsequent upload, so make sure to also update your YAML configuration).
this will be overwritten by any subsequent upload (unless ``keep_user_credentials`` is enabled) so make sure to also update your YAML configuration).
Additionally, you can upload a new firmware file.
@ -34,9 +34,16 @@ manually in your browser.
password: !secret wifi_ap_password
captive_portal:
# Set to true to preserve captive_portal credentials over OTA updates
# Note that you can't set STA credentials in YAML if you're using this
keep_user_credentials: false
No configuration variables.
Configuration variables:
------------------------
- **keep_user_credentials** (*Optional*, boolean): Do not erase WiFi credentials entered using :doc:`captive_portal` over subsequent OTA updates.
Note: WiFi STA credentials cannot be set in YAML when using this.
See Also
--------

3
guides/creators.rst
View File

@ -49,6 +49,9 @@ Example configuration
# In combination with the `ap` this allows the user
# to provision wifi credentials to the device.
captive_portal:
# Optionally, preserve provisioned credentials
# over subsequent OTA updates.
keep_user_credentials: true
# Sets up Bluetooth LE (Only on ESP32) to allow the user
# to provision wifi credentials to the device.