Document OpenSSL 3.x dependency change for openSUSE/SLES packages

[Copilot]

.NET packages for openSUSE and SLES now depend on OpenSSL 3.x instead of 1.x. Newer distro versions no longer ship OpenSSL 1.x, breaking package installations. Since .NET 6+ already supports OpenSSL 3.x at runtime, this is purely a package dependency update.

Changes

• Breaking change article: Added deployment/8.0/opensuse-sles-openssl3-dependency.md documenting the dependency change for .NET 6, 7, 8+
• TOC and index: Integrated new article into compatibility documentation structure
• Installation guides: Updated linux-opensuse.md and linux-sles.md to reflect libopenssl3 dependency and removed obsolete compat-openssl10 references

Impact

Most users unaffected—package managers handle OpenSSL 3.x installation automatically. Systems with both OpenSSL versions may need configuration adjustments.

References

• nothing provides 'libopenssl1_0_0' needed by the to be installed dotnet-runtime-deps-8.0-8.0.22-1.x86_64 runtime#122443
• [release/8.0] Update openSUSE and SLES OpenSSL dependency to libopenssl3 runtime#122653

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Breaking change]: .NET packages for openSUSE and SLES will be updated to depend on OpenSSL 3.x</issue_title>
<issue_description>### Description

We recently found that one of the distro versions that users install these packages on no longer offers OpenSSL 1.x, which breaks the dependency requirements on our packages. .NET 6+ supports OpenSSL 3.x so this change is solely a change in package dependencies.

It's possible that someone is using these packages on a system that offers both OpenSSL 1.x and 3.x and this change will break some aspect of their system. The current behavior is already breaking people, so this risk seems warranted.

Context:

• [release/8.0] Update openSUSE and SLES OpenSSL dependency to libopenssl3 runtime#122653

Version

.NET 8

Previous behavior

.NET packages depend on OpenSSL 1.x

New behavior

.NET packages depend on OpenSSL 3.x

Type of breaking change

• Binary incompatible: Existing binaries might encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
• Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code might require source changes to compile successfully.
• Behavioral change: Existing binaries might behave differently at run time.

Reason for change

See:

• nothing provides 'libopenssl1_0_0' needed by the to be installed dotnet-runtime-deps-8.0-8.0.22-1.x86_64 runtime#122443

Recommended action

Most user don't need to do anything. If this change breaks your system, you may need to either make other changes to your system or sttop installing .NET via packages.

Feature area

Other (please put exact area in description textbox)

Affected APIs

No response</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [Breaking change]: .NET packages for openSUSE and SLES will be updated to depend on OpenSSL 3.x #50709

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

---

Internal previews

📄 File	🔗 Preview link
docs/core/compatibility/8.0.md	Breaking changes in .NET 8
docs/core/compatibility/deployment/8.0/opensuse-sles-openssl3-dependency.md	.NET packages for openSUSE and SLES depend on OpenSSL 3.x
docs/core/compatibility/toc.yml	docs/core/compatibility/toc
docs/core/install/linux-opensuse.md	Install the .NET SDK or the .NET Runtime on openSUSE Leap
docs/core/install/linux-sles.md	[.NET 10](https://review.learn.microsoft.com/en-us/dotnet/core/install/linux-sles?branch=pr-en-us-50895)

[Copilot]

Pull request overview

This PR documents a breaking change where .NET packages for openSUSE and SLES distributions now depend on OpenSSL 3.x instead of OpenSSL 1.x, affecting .NET 6, 7, and 8+. The change addresses installation failures on newer distribution versions that no longer ship OpenSSL 1.x.

Key Changes

• Added comprehensive breaking change documentation explaining the OpenSSL dependency update
• Updated installation guides to reflect the new libopenssl3 dependency requirement
• Integrated the breaking change article into compatibility documentation structure

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
docs/core/compatibility/deployment/8.0/opensuse-sles-openssl3-dependency.md	New breaking change article documenting the OpenSSL 3.x dependency change
docs/core/compatibility/toc.yml	Added TOC entry for the new breaking change article in the Deployment section
docs/core/compatibility/8.0.md	Added index entry for the breaking change in the .NET 8 compatibility overview
docs/core/install/linux-sles.md	Updated dependencies list to reference libopenssl3 with important note about the change
docs/core/install/linux-opensuse.md	Updated dependencies list to reference libopenssl3 with important note about the change