msquic/docs/Platforms.md

2.1 KiB

Platform Support

MsQuic currently officially supports the following platform configurations. Information on support for MsQuic itself is located in Release.md.

Windows

On Windows, by default, MsQuic relies on built-in support from Schannel for TLS 1.3 functionality. MsQuic is shipped in-box in the Windows kernel in the form of the msquic.sys driver, to support built-in HTTP and SMB features. User mode applications use msquic.dll (built from here) and package it with their app.

Important This configuration requires running either Windows Server 2022, Windows 11 or the latest Windows Insider Preview Builds for Schannel's TLS 1.3 support.

Important This configuration does not support 0-RTT due to Schannel's current lack of support.

OpenSSL

Optionally, msquic.dll can be built with OpenSSL (see below for more details) instead of Schannel on Windows. This removes the Windows OS dependency on TLS from MsQuic, so MsQuic should work on most Windows 10 based client and server versions (it may work on even older Windows releases but supporting them is not a goal for MsQuic). Both version 1.1 and 3.1 of OpenSSL are supported.

Linux

On Linux, MsQuic relies on OpenSSL for TLS 1.3 functionality. Both version 1.1 and 3.1 are supported. The libmsquic package will generally depend on the default OS installed OpenSSL version's libcrypto.

Important This configuration relies on a fork of OpenSSL for QUIC/TLS support. It is still currently unknown as to when mainline will support QUIC. See here for more details. MsQuic with OpenSSL does fully support 0-RTT.

Other

For testing or experimentation purposes, MsQuic may be built with other configurations, but they are not to be considered officially supported unless they are listed above. Any bugs found while using these configurations may be looked at, but no guarantees are provided that they will be fixed.