This page here has been created for the latest stable release of Salvus. You have chosen to view the documentation for another Salvus version. Please be aware there might be some small differences you have to account for.

Windows Subsystem for Linux


While we have used the Linux subsystem successfully together with several clients, we do not officially support it at the moment.

With Windows 10, you can fairly easily run code in a Linux environment without the overhead of a virtual machine or installing an emulator.


To first activate and install it on your system, follow these instructions. Please note that you require admin rights on the Windows machine to enable the Linux subsystem.

If you have no specific reason to select another one we recommend to choose Ubuntu 18.04 LTS from the Microsoft store page as Linux distribution. But other Linux distributions should work just as well.

We additionally recommend to install the terminal Cmder, which we find incredibly helpful. This is optional though and you can also launch the Linux subsystem directly from the application panel.


Linux Binaries

The WSL enables the direct execution of Linux binaries. So make sure to always install the Linux version of everything (conda, Python, Salvus, ... ) into it.

There is virtually no overhead and you are ready to use the terminal as if it was a Linux system.

The Windows file system is mounted as if it was an external hard drive under the Linux subsystem. E.g., you can find the Desktop directory here:


Vice versa, you can find the contents of the Linux subsystem home directory here:


We strongly recommend to only transfer files from within the Linux subsystem (either to or from Windows).

You can now continue with installing Salvus.


SSL Connections

TLS/SSL connections (e.g. connections over HTTPS) require a few things to work correctly. A simple way to test if everything works is to run for example


in the WSL which should finish without error. In case you encounter SSH connection problems there are a few likely causes:

Anti-Virus Software

Anti-Virus software running on the Windows host has been reported to block SSL connections in the WSL.

Executing the following command in the windows powerwhell will print all active anti virus programs:

powershell.exe "Get-CimInstance -Namespace root/SecurityCenter2 -ClassName AntivirusProduct" | grep displayName

Try disabling them temporarily and see if that helps.

Proxy Settings

This can result in very similar errors. Please see this page for details.