{"slug":"network-map-response-timeout","title":"Network map response timeout","tags":["tailscale","networking"],"agent_summary":"Last validated: Jan 30, 2026","trigger_phrases":[],"runnable":false,"markdown":"\r\n# Network map response timeout\r\n\r\nLast validated: Jan 30, 2026\r\n\r\nThis topic explains a message that might 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/network-map-response-timeout\\#message-displayed-in-the-client)\r\n\r\n> Network map response timeout\r\n>\r\n> Tailscale hasn't received a network map from the coordination server in `<seconds>`.\r\n\r\n## [Message ID](https://tailscale.com/docs/reference/messages/client/network-map-response-timeout\\#message-id)\r\n\r\n`mapresponse-timeout`\r\n\r\n## [Why you're seeing this message](https://tailscale.com/docs/reference/messages/client/network-map-response-timeout\\#why-youre-seeing-this-message)\r\n\r\nThis message means the Tailscale client sent a request to the [Tailscale control plane](https://tailscale.com/docs/concepts/control-data-planes) for the network map, which is the data describing what devices are in your tailnet and how to reach them, but did not receive a response in time. Without a timely network map response, the client cannot fully update its network display, which can delay or disrupt connectivity even when the client is running.\r\n\r\n## [What to do](https://tailscale.com/docs/reference/messages/client/network-map-response-timeout\\#what-to-do)\r\n\r\nHere are some things you can try to resolve this issue:\r\n\r\n- [Check that the device has a stable internet connection](https://tailscale.com/docs/reference/troubleshooting/connectivity/connect-internet-failure) and can reach external services.\r\n- Restart the Tailscale client to refresh the connection.\r\n- Update Tailscale to the latest version.\r\n- Verify firewalls, proxies, and other security software are not blocking outbound HTTPS or long-lived connections used by Tailscale.\r\n- Verify the system clock is accurate. This can break control plane communication.\r\n- Try switching to a different network or internet connection to rule out network filtering.\r\n- Check for restrictive corporate or [captive networks](https://tailscale.com/docs/integrations/captive-portals) that might block WebSocket or HTTPS traffic.\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>Network map response timeout</h1>\n<p>Last validated: Jan 30, 2026</p>\n<p>This topic explains a message that might 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/network-map-response-timeout#message-displayed-in-the-client\">Message displayed in the client</a></h2>\n<blockquote>\n<p>Network map response timeout</p>\n<p>Tailscale hasn't received a network map from the coordination server in <code>&#x3C;seconds></code>.</p>\n</blockquote>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/network-map-response-timeout#message-id\">Message ID</a></h2>\n<p><code>mapresponse-timeout</code></p>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/network-map-response-timeout#why-youre-seeing-this-message\">Why you're seeing this message</a></h2>\n<p>This message means the Tailscale client sent a request to the <a href=\"https://tailscale.com/docs/concepts/control-data-planes\">Tailscale control plane</a> for the network map, which is the data describing what devices are in your tailnet and how to reach them, but did not receive a response in time. Without a timely network map response, the client cannot fully update its network display, which can delay or disrupt connectivity even when the client is running.</p>\n<h2><a href=\"https://tailscale.com/docs/reference/messages/client/network-map-response-timeout#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><a href=\"https://tailscale.com/docs/reference/troubleshooting/connectivity/connect-internet-failure\">Check that the device has a stable internet connection</a> and can reach external services.</li>\n<li>Restart the Tailscale client to refresh the connection.</li>\n<li>Update Tailscale to the latest version.</li>\n<li>Verify firewalls, proxies, and other security software are not blocking outbound HTTPS or long-lived connections used by Tailscale.</li>\n<li>Verify the system clock is accurate. This can break control plane communication.</li>\n<li>Try switching to a different network or internet connection to rule out network filtering.</li>\n<li>Check for restrictive corporate or <a href=\"https://tailscale.com/docs/integrations/captive-portals\">captive networks</a> that might block WebSocket or HTTPS traffic.</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"}