Skip to content

[esphome] Document esphome: provisioning:#6833

Open
kbx81 wants to merge 2 commits into
esphome:nextfrom
kbx81:api-provisioning-timeout
Open

[esphome] Document esphome: provisioning:#6833
kbx81 wants to merge 2 commits into
esphome:nextfrom
kbx81:api-provisioning-timeout

Conversation

@kbx81

@kbx81 kbx81 commented Jun 23, 2026

Copy link
Copy Markdown
Member

Description

Documents the new provisioning window on the core esphome: component page (esphome: provisioning: with timeout and on_timeout).

Covers what closing the window does (refuses provisioning, turns API clients away, stops BLE Improv — serial Improv stays enabled) and that reboot_timeout is paused while unprovisioned, with a power cycle / reset reopening the window.

Related issue (if applicable): N/A

Pull request in esphome with YAML changes (if applicable):

Checklist

  • I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • Link added in /src/content/docs/components/index.mdx when creating new documents for new components or cookbook.

Document the new (API) provisioning window: the `provisioning_timeout`
configuration variable, its interaction with `reboot_timeout`, and the
`on_provisioning_timeout` trigger.

Companion to esphome/esphome#17152.
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit 33cb8d0
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/6a3b538f4af52a0008fd2521
😎 Deploy Preview https://deploy-preview-6833--esphome.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

The provisioning window moved out of the api component into the core
`esphome: provisioning:` block. Revert the api.mdx additions and document
`provisioning` (with `timeout` and `on_timeout`) on the esphome core page.

Companion to esphome/esphome#17152.
@kbx81 kbx81 changed the title [api] Document provisioning_timeout and on_provisioning_timeout [esphome] Document esphome: provisioning: Jun 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant