# Troubleshooting guide

Last validated Jan 5, 2026

This topic contains various suggestions and tips to help troubleshoot common issues. If you have additional issues, [contact Tailscale Support][co-contact-support].

## Connectivity and network issues

* For basic device connectivity issues, refer to [Troubleshoot device connectivity][docs-troubleshoot-connectivity].
* For network configuration issues, refer to [Troubleshoot network configuration][docs-troubleshoot-network-configuration].
* For general network troubleshooting (that is, not specific to Tailscale), refer to [Basic network troubleshooting][docs-basic-network-troubleshooting].

## Issues related to a specific operating system

For OS-specific Tailscale troubleshooting, refer to the following:

* [Troubleshooting guide for Apple][docs-troubleshooting-apple]
* [Troubleshooting guide for Linux][docs-troubleshooting-linux]
* [Troubleshooting guide for Windows][docs-troubleshooting-windows]

## Mobile device issues

For mobile device issues, refer to [Troubleshooting mobile devices][docs-troubleshooting-mobile].

## Container issues

For container issues, refer to [Troubleshooting containers][docs-troubleshooting-containers].

## Cloud environment issues

For cloud environment issues, refer to [Troubleshooting cloud environments][docs-troubleshooting-cloud].

## Additional resources

If you need to generate a bug report to help Tailscale Support debug an issue, follow the instructions at [Generate a bug report][docs-bug-report].

If you want to enable debug mode for the Tailscale client menu to assist in troubleshooting, follow the instructions at [Debug menu and options][docs-debug-menu].

[co-contact-support]: /contact/support

[docs-basic-network-troubleshooting]: /docs/reference/troubleshooting/basic-network-troubleshooting

[docs-bug-report]: /docs/account/bug-report

[docs-debug-menu]: /docs/reference/debug-menu

[docs-troubleshooting-mobile]: /docs/reference/troubleshooting/mobile

[docs-troubleshoot-connectivity]: /docs/reference/troubleshooting/connectivity

[docs-troubleshoot-network-configuration]: /docs/reference/troubleshooting/network-configuration

[docs-troubleshooting-apple]: /docs/reference/troubleshooting/apple

[docs-troubleshooting-cloud]: /docs/reference/troubleshooting/cloud

[docs-troubleshooting-containers]: /docs/reference/troubleshooting/containers

[docs-troubleshooting-linux]: /docs/reference/troubleshooting/linux

[docs-troubleshooting-windows]: /docs/reference/troubleshooting/windows