Tailscale Connection Timeouts

[andrew-hossack]

The problem

The Tailscale API tends to timeout every few minutes, leading to messages like you see below for devices "Unavailable".

This issue seems to be intermittent, since every few minutes the connection seems to self-correct, and I am then able to view device metrics once again. Moreover, re-syncing the Tailscale add-on fixes the timeout issue temporarily.

What version of Home Assistant Core has the issue?

core-2025.2.4

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant Container

Integration causing the issue

tailscale

Link to integration documentation on our website

https://www.home-assistant.io/integrations/tailscale/

Diagnostics information

home-assistant_tailscale_2025-02-21T18-18-29.702Z.log

Example YAML snippet

Anything in the logs that might be useful for us?

Tailing `/config/home-assistant.log` yields the following error:


File "/usr/local/lib/python3.13/site-packages/tailscale/tailscale.py", line 89, in _request
    raise TailscaleConnectionError(msg) from exception
tailscale.exceptions.TailscaleConnectionError: Timeout occurred while connecting to the Tailscale API

Additional information

No response

[home-assistant]

Hey there @frenck, mind taking a look at this issue as it has been labeled with an integration (tailscale) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of tailscale can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign tailscale Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the issue.

_{^{(message by CodeOwnersMention)}}

---

tailscale documentation
tailscale source
_{^{(message by IssueLinks)}}