{"slug":"coordination-server-reports-an-issue","title":"Coordination server reports an issue","tags":["tailscale"],"agent_summary":"Last validated: Aug 1, 2025","trigger_phrases":[],"runnable":false,"markdown":"\r\n# Coordination server reports an issue\r\n\r\nLast validated: Aug 1, 2025\r\n\r\nThis topic explains a message that may appear in the Tailscale client and the actions you can take to address it. For a list of currently documented messages in the Tailscale admin console and client, refer to the main [Messages](https://tailscale.com/docs/reference/messages) topic.\r\n\r\n## [Message displayed in the client](https://tailscale.com/docs/reference/messages/client/coordination-server-issue\\#message-displayed-in-the-client)\r\n\r\n> Coordination server reports an issue\r\n>\r\n> The coordination server is reporting a health issue: `<reported-issue>`\r\n\r\n## [Reference ID](https://tailscale.com/docs/reference/messages/client/coordination-server-issue\\#reference-id)\r\n\r\n`control-health`\r\n\r\n## [Why you're seeing this message](https://tailscale.com/docs/reference/messages/client/coordination-server-issue\\#why-youre-seeing-this-message)\r\n\r\nThe coordination server is responsible for device discovery, authentication, key distribution, policy enforcement, and distributing network configurations to all devices in your tailnet.\r\n\r\nThis message may appear when the coordination server is not reachable. There are multiple reasons why this can happen, including the following:\r\n\r\n- There is an issue on our end.\r\n- A router, firewall, or network configuration was recently updated, causing connectivity issues.\r\n- You were recently assigned a new public IP address and the client is attempting to re-establishing a connection to the coordination server.\r\n\r\n## [What to do](https://tailscale.com/docs/reference/messages/client/coordination-server-issue\\#what-to-do)\r\n\r\nHere are some things you can try to resolve this issue:\r\n\r\n- Restart your Tailscale client using the client UI, or run the CLI commands `tailscale down` followed by `tailscale up`.\r\n- Check your internet connection.\r\n- Wait a few minutes and restart the Tailscale client.\r\n- Check your firewall rules.\r\n- Check the [Tailscale Status](https://status.tailscale.com/) page. If there is an issue on our end that impacts any of our services, it will be reported here.\r\n\r\n## [Additional information](https://tailscale.com/docs/reference/messages/client/coordination-server-issue\\#additional-information)\r\n\r\n- For information about coordination server outages, refer to [What happens if the coordination server is down?](https://tailscale.com/docs/reference/coordination-server-down).\r\n- For information about the Tailscale coordination server, refer to [Control and data planes](https://tailscale.com/docs/concepts/control-data-planes).\r\n- For information about using firewalls with Tailscale, refer to [Using Tailscale with your firewall](https://tailscale.com/docs/integrations/firewalls).\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>Coordination server reports an issue</h1>\n<p>Last validated: Aug 1, 2025</p>\n<p>This topic explains a message that may appear in the Tailscale client and the actions you can take to address it. For a list of currently documented messages in the Tailscale admin console and client, refer to the main <a href=\"https://tailscale.com/docs/reference/messages\">Messages</a> topic.</p>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/coordination-server-issue#message-displayed-in-the-client\">Message displayed in the client</a></h2>\n<blockquote>\n<p>Coordination server reports an issue</p>\n<p>The coordination server is reporting a health issue: <code>&#x3C;reported-issue></code></p>\n</blockquote>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/coordination-server-issue#reference-id\">Reference ID</a></h2>\n<p><code>control-health</code></p>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/coordination-server-issue#why-youre-seeing-this-message\">Why you're seeing this message</a></h2>\n<p>The coordination server is responsible for device discovery, authentication, key distribution, policy enforcement, and distributing network configurations to all devices in your tailnet.</p>\n<p>This message may appear when the coordination server is not reachable. There are multiple reasons why this can happen, including the following:</p>\n<ul>\n<li>There is an issue on our end.</li>\n<li>A router, firewall, or network configuration was recently updated, causing connectivity issues.</li>\n<li>You were recently assigned a new public IP address and the client is attempting to re-establishing a connection to the coordination server.</li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/coordination-server-issue#what-to-do\">What to do</a></h2>\n<p>Here are some things you can try to resolve this issue:</p>\n<ul>\n<li>Restart your Tailscale client using the client UI, or run the CLI commands <code>tailscale down</code> followed by <code>tailscale up</code>.</li>\n<li>Check your internet connection.</li>\n<li>Wait a few minutes and restart the Tailscale client.</li>\n<li>Check your firewall rules.</li>\n<li>Check the <a href=\"https://status.tailscale.com/\">Tailscale Status</a> page. If there is an issue on our end that impacts any of our services, it will be reported here.</li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/coordination-server-issue#additional-information\">Additional information</a></h2>\n<ul>\n<li>For information about coordination server outages, refer to <a href=\"https://tailscale.com/docs/reference/coordination-server-down\">What happens if the coordination server is down?</a>.</li>\n<li>For information about the Tailscale coordination server, refer to <a href=\"https://tailscale.com/docs/concepts/control-data-planes\">Control and data planes</a>.</li>\n<li>For information about using firewalls with Tailscale, refer to <a href=\"https://tailscale.com/docs/integrations/firewalls\">Using Tailscale with your firewall</a>.</li>\n</ul>\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"}