{
    "componentChunkName": "component---src-templates-markdown-doc-tsx",
    "path": "/2025.1.3/installation/platform_specific/windows_subsystem_for_linux",
    "result": {"data":{"mdx":{"id":"669b5829-a302-5c42-a085-cc4eb8e1facb","frontmatter":{"title":"","images":null},"body":"var _excluded = [\"components\"];\nfunction _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(Preamble, {\n    platform: 'windows_wsl',\n    mdxType: \"Preamble\"\n  }), mdx(\"p\", null, \"With \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Windows 10\"), \" and \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"11\"), \", one can run programs on a Windows machine as if\\nit was a Linux machine. This is done by using the Windows Subsystem for Linux\\n(\", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"WSL\"), \"), developed by Microsoft. Salvus works well in it, even offering\\nsupport for Nvidia GPU acceleration. There is little overhead using WSL\\ncompared to using Linux natively, and Salvus doesn't take a large performance\\nhit.\"), mdx(WhereToInstall, {\n    sectionNumber: 1,\n    mdxType: \"WhereToInstall\"\n  }), mdx(\"h3\", null, \"2. Installing the Windows Subsystem for Linux\"), mdx(Message, {\n    color: \"violet\",\n    header: \"Use WSL 2\",\n    content: mdx(\"div\", null, mdx(\"p\", null, \"Please use WSL 2 - Salvus does not work with WSL 1. WSL 2 will be installed by default if you don't alter the installation process.\")),\n    mdxType: \"Message\"\n  }), mdx(\"p\", null, \"On \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Windows 11\"), \" it can be installed via the Microsoft store. Alternatively,\\nfollow \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://docs.microsoft.com/en-us/windows/wsl/install\"\n  }, \"these\\ninstructions\"), \" on either\\nWindows 10 or 11. Please note that you \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"require administrator rights\"), \" on the\\nmachine to enable the Linux subsystem.\"), mdx(\"p\", null, \"If you have no specific preference for systems, we recommend to choose Ubuntu\\n20.04 LTS from the Microsoft store page as Linux distribution, as that has seen\\nthe most extensive testing. Other Linux distributions should in principle work\\nas well.\"), mdx(\"p\", null, \"The WSL enables the direct execution of Linux binaries. So make sure to\\nalways install the \", mdx(\"b\", null, \"Linux version of everything\"), \" (Miniforge,\\nPython, Salvus, ... ) into it.\"), mdx(\"h4\", null, \"Where are my files?\"), mdx(\"p\", null, \"Within the virtual Linux system that WSL creates, the original Windows file\\nsystem is mounted as if it was an external hard drive under the Linux\\nsubsystem. For example, you can find the Windows \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"Desktop\"), \" directory here:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"/mnt/c/Users/WindowsUserName/Desktop\\n\")), mdx(\"p\", null, \"Conversely, the WSL installation should also show the Linux file system in the\\nthe Windows Explorer as network mounts. These can be immediately found by\\nentering \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"\\\\\\\\wsl$\"), \" in the top navigation bar. Additionally, you can access this\\npath also using your Windows native shell:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"\\\\\\\\wsl$\\n\")), mdx(InstallingCondaMamba, {\n    platform: 'windows_wsl',\n    sectionNumber: 3,\n    mdxType: \"InstallingCondaMamba\"\n  }), mdx(RunningDownloader, {\n    platform: 'windows_wsl',\n    sectionNumber: 4,\n    mdxType: \"RunningDownloader\"\n  }), mdx(SiteSetup, {\n    platform: 'windows_wsl',\n    sectionNumber: 5,\n    mdxType: \"SiteSetup\"\n  }), mdx(ContinueLearning, {\n    platform: 'windows_wsl',\n    sectionNumber: 6,\n    mdxType: \"ContinueLearning\"\n  }), mdx(\"h3\", null, \"7. Nvidia GPUs\"), mdx(\"p\", null, \"Salvus greatly benefits from running on Nvidia GPUs which is supported in the\\nWSL as described on \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://docs.nvidia.com/cuda/wsl-user-guide/index.html\"\n  }, \"this Nvidia\\npage\"), \" . We recommend to\\nuse Windows 11 for this which by far has the easiest set-up process.\"), mdx(\"h3\", null, \"8. Troubleshooting\"), mdx(\"p\", null, \"A few common reasons for a Salvus installation not working correctly on \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"WSL\"), \" are described below.\"), mdx(\"h4\", null, \"SSL Connections\"), mdx(\"p\", null, \"TLS/SSL connections (e.g. connections over HTTPS) require a few things to work\\ncorrectly. If you see an error code referencing any of these terms, there might\\nbe some connection issues. A simple way to test if everything works is to run\\nthe following from the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"WSL\"), \" shell:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-bash\"\n  }, \"wget https://google.com\\n\")), mdx(\"p\", null, \"which should finish without error. In case you encounter\\nSSH connection problems there are a few likely causes:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Anti-Virus Software\"), \": Anti-virus software running on the \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Windows\"), \" host\\nhas been reported to block SSL connections in the \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"WSL\"), \". Executing the\\nfollowing command in the \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Windows\"), \" native powershell will print all active\\nanti virus programs. Try disabling them temporarily and check if Salvus does\\nrun successfully afterwards.\")), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-shell\"\n  }, \"powershell.exe \\\"Get-CimInstance -Namespace root/SecurityCenter2 -ClassName AntivirusProduct\\\" | grep displayName\\n\")), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Proxy Settings\"), \": This can result in very similar errors. Please see \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://docs.mondaic.com/installation/proxy_configuration\"\n  }, \"this\\npage\"), \" for details.\")));\n}\n;\nMDXContent.isMDXComponent = true;"},"site":{"siteMetadata":{"salvusDocVersions":{"current":"2026.5.0"}}}},"pageContext":{"id":"669b5829-a302-5c42-a085-cc4eb8e1facb"}},
    "staticQueryHashes": ["1756726491","1865182279","3419370438","3597190305","4112489441","519097329"]}