Windows Support Policy

This site is the new docs site currently being tested. For the actual docs in use please go to https://www.jenkins.io/doc.

This page documents the Windows support policy for the Jenkins controller and agents.

Scope

Jenkins plugins may set additional requirements to Windows versions on controllers and/or agents. This page does not document such requirements. Please refer to plugin documentation.

Why?

Theoretically, Jenkins can run everywhere where you can run a supported Java version, but there are some limitations in practice. Jenkins core and some plugins include native code or depend on Windows API and subsystems, and hence they rely on specific Windows platforms and versions. In Windows services, we also use Windows Service Wrapper (WinSW), which requires .NET Framework.

Support levels

We define multiple support levels for Windows platforms.

Support level Description Platforms

Level 1 - Full support

We run automated testing for these platforms, and we intend to fix reported issues timely.

  • 64-bit (amd-64) Windows Server versions, with the latest GA update pack

  • Windows versions used in the official Docker images

Level 2 - Supported

We do not actively test these platforms, but we intend to keep compatibility. We are happy to accept patches.

  • 64-bit (amd-64) Windows Server versions generally supported by Microsoft

  • 64-bit (amd-64) Windows 10 and 11 versions generally supported by Microsoft

Level 3 - Patches considered

Support may have limitations and extra requirements. We do not test compatibility, and we may drop support if there is a need. We will consider patches if they do not put Levels 1 or 2 support at risk and do not create maintenance overhead.

  • x86 and other non-amd64 architectures

  • Non-mainstream versions, e.g., Windows Embedded

  • Preview releases

  • Windows API emulation engines, e.g., Wine or ReactOS

Level 4 - Unsupported

These versions are known to be incompatible or to have severe limitations. We do not support the listed platforms, and we will not accept patches.

  • Windows versions no longer supported by Microsoft

  • Windows XP older than SP3

  • Windows Phone

  • Other Windows platforms released before 2008

.NET Requirements

  • Starting from Jenkins 2.238, .NET Framework 4.0 or above is required for all Windows service installations and built-in Windows service management logic.

  • Before Jenkins 2.238, .NET Framework 2.0 was supported

  • For platforms that do not support these versions, consider using Native executables provided by the Windows Service Wrapper project.

Contributing

If you would like to add support for more Windows platforms or to share feedback, we honestly appreciate your contributions! Windows support in Jenkins is Platform Special Interest Group which has a chat, a mailing list, and regular meetings. You are welcome to join these channels.

Version history