Get started - it's free!
Log in
© 2025

MagicSock function not running

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 Messages topic.

Message displayed in the client

MagicSock function not running

The MagicSock function <function-name> is not running. You might experience connectivity issues.

Message ID

magicsock-receive-func-error

Why you're seeing this message

MagicSock is a Tailscale networking layer that is responsible for discovering and selecting networking paths and handling packet transport in your tailnet. When you install the Tailscale client, it runs as a background service. When this error displays, it's usually because a function of the service has failed. The functions associated with MagicSock include creating new connections, discovery, network map updates, encrypted key updates, and switching between UDP and DERP relay servers.

Here are some reasons why this message might display:

  • There was an issue with your Tailscale client installation.
  • There was an issue switching between peer-to-peer UDP connections and DERP server relay connections.
  • A firewall on your network is blocking UDP ports or is in some other way blocking connections.

What to do

Here are some things you can try to resolve this issue:

  • Restart the Tailscale client.
  • If you are using a firewall, verify that the ports and domains used for connecting to Tailscale are not blocked.
  • Update your Tailscale client, if it's not already on the most current version.
  • Reinstall the Tailscale client.
  • Generate a bug report and send it to Tailscale Support.

Additional reference

Last updated Jul 31, 2025