{"slug":"install-tailscale-on-windows-with-wsl-2","title":"Install Tailscale on Windows with WSL 2","tags":["tailscale","setup"],"agent_summary":"Last validated: Nov 3, 2025","trigger_phrases":[],"runnable":false,"markdown":"\r\n# Install Tailscale on Windows with WSL 2\r\n\r\nLast validated: Nov 3, 2025\r\n\r\nThe current version of the Tailscale client available for [download](https://tailscale.com/download/windows) requires Windows 10 or later or Windows Server 2016 or later.\r\n\r\nInstalling Tailscale on WSL 2 is an advanced concept. You can find more information about WSL in [Microsoft's documentation](https://learn.microsoft.com/en-us/windows/wsl).\r\n\r\nThere is a specific issue with packet size and Tailscale. You can follow this [GitHub issue](https://github.com/tailscale/tailscale/issues/4833) for details. Report any performance issues on this thread if it is related.\r\n\r\nThis topic shows how to install Tailscale within the Windows Subsystem for Linux (WSL 2) package. If you want to use the Tailscale\r\n`.exe` installer, refer to [Install Tailscale on Windows](https://tailscale.com/docs/install/windows). If you want to use the\r\nTailscale `.msi` installer, refer to [Install Tailscale on Windows with MSI](https://tailscale.com/docs/install/windows/msi).\r\n\r\n## [To install](https://tailscale.com/docs/install/windows/wsl2\\#to-install)\r\n\r\n1. Verify that you are on WSL 2. From PowerShell, run the following command: `wsl -l -v`. In the `VERSION` column `2` will display. This means you are using WSL 2.\r\n2. Start your WSL 2 instance from PowerShell by running `wsl.exe` or opening up a Linux terminal tab (if you have it already configured).\r\n3. Run the automatic installation script:\r\n\r\n```shell\r\ncurl -fsSL https://tailscale.com/install.sh | sh\r\n```\r\n\r\nYou can find more detailed instructions in [Install Tailscale on Linux](https://tailscale.com/docs/install/linux) page, including a manual installation process.\r\n\r\n1. After the installation completes, Tailscale will not yet be running, so you will need to follow the text prompt after the installation and run `sudo tailscale up`. This will post a Tailscale URL that you can select or copy and paste into your browser.\r\n2. When your browser window launches you will need to authenticate\r\nusing [your SSO identity provider](https://tailscale.com/docs/integrations/identity).\r\n3. Follow the prompts to add this node to your tailnet and your new WSL 2 node will display in the [Machines](https://login.tailscale.com/admin/machines) shortly.\r\n\r\n## [To uninstall](https://tailscale.com/docs/install/windows/wsl2\\#to-uninstall)\r\n\r\nUsers can uninstall Tailscale by running the following command: `sudo apt-get remove tailscale`.\r\n\r\n## [Considerations](https://tailscale.com/docs/install/windows/wsl2\\#considerations)\r\n\r\n- Your new WSL 2 node will most likely have the same name as your Windows node and it might show up in the Tailscale admin page as a duplicate name or with an appended number. You can rename your node in the Tailscale [Machines](https://login.tailscale.com/admin/machines) page to reflect that it is your WSL 2 node.\r\n- If you run Tailscale on both the Windows host and inside WSL 2 at the same time, Tailscale encrypted traffic that flows from WSL 2 over Tailscale on the Windows host will not work due to Tailscale packets not being able to fit in Tailscale packets. For this reason it is recommended that users run Tailscale on the Windows host only, and not inside WSL 2.\r\n- If you run Tailscale inside WSL 2, the current versions of WSL 2 have a default `MTU` of `1280` on their default interface, which is not large enough for Tailscale to function. There is a workaround inside `tailscaled` that will raise the `MTU` of the default interface to `1340` if it detects that you're on WSL and it is using what appears to be this default `MTU`.\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>Install Tailscale on Windows with WSL 2</h1>\n<p>Last validated: Nov 3, 2025</p>\n<p>The current version of the Tailscale client available for <a href=\"https://tailscale.com/download/windows\">download</a> requires Windows 10 or later or Windows Server 2016 or later.</p>\n<p>Installing Tailscale on WSL 2 is an advanced concept. You can find more information about WSL in <a href=\"https://learn.microsoft.com/en-us/windows/wsl\">Microsoft's documentation</a>.</p>\n<p>There is a specific issue with packet size and Tailscale. You can follow this <a href=\"https://github.com/tailscale/tailscale/issues/4833\">GitHub issue</a> for details. Report any performance issues on this thread if it is related.</p>\n<p>This topic shows how to install Tailscale within the Windows Subsystem for Linux (WSL 2) package. If you want to use the Tailscale\r\n<code>.exe</code> installer, refer to <a href=\"https://tailscale.com/docs/install/windows\">Install Tailscale on Windows</a>. If you want to use the\r\nTailscale <code>.msi</code> installer, refer to <a href=\"https://tailscale.com/docs/install/windows/msi\">Install Tailscale on Windows with MSI</a>.</p>\n<h2><a href=\"https://tailscale.com/docs/install/windows/wsl2#to-install\">To install</a></h2>\n<ol>\n<li>Verify that you are on WSL 2. From PowerShell, run the following command: <code>wsl -l -v</code>. In the <code>VERSION</code> column <code>2</code> will display. This means you are using WSL 2.</li>\n<li>Start your WSL 2 instance from PowerShell by running <code>wsl.exe</code> or opening up a Linux terminal tab (if you have it already configured).</li>\n<li>Run the automatic installation script:</li>\n</ol>\n<pre><code class=\"language-shell\">curl -fsSL https://tailscale.com/install.sh | sh\n</code></pre>\n<p>You can find more detailed instructions in <a href=\"https://tailscale.com/docs/install/linux\">Install Tailscale on Linux</a> page, including a manual installation process.</p>\n<ol>\n<li>After the installation completes, Tailscale will not yet be running, so you will need to follow the text prompt after the installation and run <code>sudo tailscale up</code>. This will post a Tailscale URL that you can select or copy and paste into your browser.</li>\n<li>When your browser window launches you will need to authenticate\r\nusing <a href=\"https://tailscale.com/docs/integrations/identity\">your SSO identity provider</a>.</li>\n<li>Follow the prompts to add this node to your tailnet and your new WSL 2 node will display in the <a href=\"https://login.tailscale.com/admin/machines\">Machines</a> shortly.</li>\n</ol>\n<h2><a href=\"https://tailscale.com/docs/install/windows/wsl2#to-uninstall\">To uninstall</a></h2>\n<p>Users can uninstall Tailscale by running the following command: <code>sudo apt-get remove tailscale</code>.</p>\n<h2><a href=\"https://tailscale.com/docs/install/windows/wsl2#considerations\">Considerations</a></h2>\n<ul>\n<li>Your new WSL 2 node will most likely have the same name as your Windows node and it might show up in the Tailscale admin page as a duplicate name or with an appended number. You can rename your node in the Tailscale <a href=\"https://login.tailscale.com/admin/machines\">Machines</a> page to reflect that it is your WSL 2 node.</li>\n<li>If you run Tailscale on both the Windows host and inside WSL 2 at the same time, Tailscale encrypted traffic that flows from WSL 2 over Tailscale on the Windows host will not work due to Tailscale packets not being able to fit in Tailscale packets. For this reason it is recommended that users run Tailscale on the Windows host only, and not inside WSL 2.</li>\n<li>If you run Tailscale inside WSL 2, the current versions of WSL 2 have a default <code>MTU</code> of <code>1280</code> on their default interface, which is not large enough for Tailscale to function. There is a workaround inside <code>tailscaled</code> that will raise the <code>MTU</code> of the default interface to <code>1340</code> if it detects that you're on WSL and it is using what appears to be this default <code>MTU</code>.</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"}