Skip to content

No troubleshooting docs for api Socket operation failed log line #6929

Description

@bdraco

Feedback

The api component page has no troubleshooting section. Devices log Socket operation failed with an APIError detail (tag api.connection, level W, esphome/components/api/api_connection.cpp) for DNS, firewall and general network problems, and users file issues quoting this line, but there is no docs section explaining the common causes or what to check.

Suggestion: add a troubleshooting section to the api page covering the usual causes (name resolution, firewalls and VLANs, connection limits, encrypted vs plaintext mismatches).

URL

https://esphome.io/components/api/

Additional information

The ESPHome Device Builder logs UI now links runtime log lines to their documentation (esphome/device-builder-frontend#1116). This line currently has nothing useful to link; once a troubleshooting section exists we will point the log line directly at it.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions