{"slug":"troubleshooting-guide","title":"Troubleshooting guide","tags":["tailscale"],"agent_summary":"Last validated: Jan 5, 2026","trigger_phrases":[],"runnable":false,"markdown":"\r\n# Troubleshooting guide\r\n\r\nLast validated: Jan 5, 2026\r\n\r\nThis topic contains various suggestions and tips to help troubleshoot common issues. If you have additional issues, [contact Tailscale Support](https://tailscale.com/contact/support).\r\n\r\n## [Connectivity and network issues](https://tailscale.com/docs/reference/troubleshooting\\#connectivity-and-network-issues)\r\n\r\n- For basic device connectivity issues, refer to [Troubleshoot device connectivity](https://tailscale.com/docs/reference/troubleshooting/connectivity).\r\n- For network configuration issues, refer to [Troubleshoot network configuration](https://tailscale.com/docs/reference/troubleshooting/network-configuration).\r\n- For general network troubleshooting (that is, not specific to Tailscale), refer to [Basic network troubleshooting](https://tailscale.com/docs/reference/troubleshooting/basic-network-troubleshooting).\r\n\r\n## [Issues related to a specific operating system](https://tailscale.com/docs/reference/troubleshooting\\#issues-related-to-a-specific-operating-system)\r\n\r\nFor OS-specific Tailscale troubleshooting, refer to the following:\r\n\r\n- [Troubleshooting guide for Apple](https://tailscale.com/docs/reference/troubleshooting/apple)\r\n- [Troubleshooting guide for Linux](https://tailscale.com/docs/reference/troubleshooting/linux)\r\n- [Troubleshooting guide for Windows](https://tailscale.com/docs/reference/troubleshooting/windows)\r\n\r\n## [Mobile device issues](https://tailscale.com/docs/reference/troubleshooting\\#mobile-device-issues)\r\n\r\nFor mobile device issues, refer to [Troubleshooting mobile devices](https://tailscale.com/docs/reference/troubleshooting/mobile).\r\n\r\n## [Container issues](https://tailscale.com/docs/reference/troubleshooting\\#container-issues)\r\n\r\nFor container issues, refer to [Troubleshooting containers](https://tailscale.com/docs/reference/troubleshooting/containers).\r\n\r\n## [Cloud environment issues](https://tailscale.com/docs/reference/troubleshooting\\#cloud-environment-issues)\r\n\r\nFor cloud environment issues, refer to [Troubleshooting cloud environments](https://tailscale.com/docs/reference/troubleshooting/cloud).\r\n\r\n## [Additional resources](https://tailscale.com/docs/reference/troubleshooting\\#additional-resources)\r\n\r\nIf you need to generate a bug report to help Tailscale Support debug an issue, follow the instructions at [Generate a bug report](https://tailscale.com/docs/account/bug-report).\r\n\r\nIf you want to enable debug mode for the Tailscale client menu to assist in troubleshooting, follow the instructions at [Debug menu and options](https://tailscale.com/docs/reference/debug-menu).\r\n\r\n![Project Logo](https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed)\r\n\r\nAsk AI\r\n\r\nreCAPTCHA\r\n\r\nRecaptcha requires verification.\r\n\r\nprotected by **reCAPTCHA**\r\n","html":"<h1>Troubleshooting guide</h1>\n<p>Last validated: Jan 5, 2026</p>\n<p>This topic contains various suggestions and tips to help troubleshoot common issues. If you have additional issues, <a href=\"https://tailscale.com/contact/support\">contact Tailscale Support</a>.</p>\n<h2><a href=\"https://tailscale.com/docs/reference/troubleshooting#connectivity-and-network-issues\">Connectivity and network issues</a></h2>\n<ul>\n<li>For basic device connectivity issues, refer to <a href=\"https://tailscale.com/docs/reference/troubleshooting/connectivity\">Troubleshoot device connectivity</a>.</li>\n<li>For network configuration issues, refer to <a href=\"https://tailscale.com/docs/reference/troubleshooting/network-configuration\">Troubleshoot network configuration</a>.</li>\n<li>For general network troubleshooting (that is, not specific to Tailscale), refer to <a href=\"https://tailscale.com/docs/reference/troubleshooting/basic-network-troubleshooting\">Basic network troubleshooting</a>.</li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/reference/troubleshooting#issues-related-to-a-specific-operating-system\">Issues related to a specific operating system</a></h2>\n<p>For OS-specific Tailscale troubleshooting, refer to the following:</p>\n<ul>\n<li><a href=\"https://tailscale.com/docs/reference/troubleshooting/apple\">Troubleshooting guide for Apple</a></li>\n<li><a href=\"https://tailscale.com/docs/reference/troubleshooting/linux\">Troubleshooting guide for Linux</a></li>\n<li><a href=\"https://tailscale.com/docs/reference/troubleshooting/windows\">Troubleshooting guide for Windows</a></li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/reference/troubleshooting#mobile-device-issues\">Mobile device issues</a></h2>\n<p>For mobile device issues, refer to <a href=\"https://tailscale.com/docs/reference/troubleshooting/mobile\">Troubleshooting mobile devices</a>.</p>\n<h2><a href=\"https://tailscale.com/docs/reference/troubleshooting#container-issues\">Container issues</a></h2>\n<p>For container issues, refer to <a href=\"https://tailscale.com/docs/reference/troubleshooting/containers\">Troubleshooting containers</a>.</p>\n<h2><a href=\"https://tailscale.com/docs/reference/troubleshooting#cloud-environment-issues\">Cloud environment issues</a></h2>\n<p>For cloud environment issues, refer to <a href=\"https://tailscale.com/docs/reference/troubleshooting/cloud\">Troubleshooting cloud environments</a>.</p>\n<h2><a href=\"https://tailscale.com/docs/reference/troubleshooting#additional-resources\">Additional resources</a></h2>\n<p>If you need to generate a bug report to help Tailscale Support debug an issue, follow the instructions at <a href=\"https://tailscale.com/docs/account/bug-report\">Generate a bug report</a>.</p>\n<p>If you want to enable debug mode for the Tailscale client menu to assist in troubleshooting, follow the instructions at <a href=\"https://tailscale.com/docs/reference/debug-menu\">Debug menu and options</a>.</p>\n<p><img src=\"https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed\" alt=\"Project Logo\"></p>\n<p>Ask AI</p>\n<p>reCAPTCHA</p>\n<p>Recaptcha requires verification.</p>\n<p>protected by <strong>reCAPTCHA</strong></p>\n"}