Skip to content

Remove dependencies that are already installed in alpine base images#52481

Open
viktor-gustafsson wants to merge 2 commits intodotnet:mainfrom
viktor-gustafsson:update-alpine-dependencies
Open

Remove dependencies that are already installed in alpine base images#52481
viktor-gustafsson wants to merge 2 commits intodotnet:mainfrom
viktor-gustafsson:update-alpine-dependencies

Conversation

@viktor-gustafsson
Copy link

@viktor-gustafsson viktor-gustafsson commented Mar 20, 2026

Summary

I noticed that the list of Alpine dependencies is inaccurate, these packages:

  • ca-certificates
  • libgcc
  • libssl3
  • libstdc++

They are already installed in the base images here
https://github.com/dotnet/dotnet-docker/tree/main/src/runtime-deps/8.0/alpine3.23
https://github.com/dotnet/dotnet-docker/tree/main/src/runtime-deps/9.0/alpine3.23
https://github.com/dotnet/dotnet-docker/tree/main/src/runtime-deps/10.0/alpine3.23
https://github.com/dotnet/dotnet-docker/tree/main/src/runtime-deps/11.0/alpine3.23

Describe your changes here.
Update Alpine dependency list based on which packages are installed in the alpine base images for dotnet 8, 9, 10 and 11


Internal previews

📄 File 🔗 Preview link
docs/core/install/linux-alpine.md docs/core/install/linux-alpine

@viktor-gustafsson viktor-gustafsson requested review from a team and adegeo as code owners March 20, 2026 11:39
Copilot AI review requested due to automatic review settings March 20, 2026 11:39
@dotnetrepoman dotnetrepoman bot added this to the March 2026 milestone Mar 20, 2026
@dotnet-policy-service dotnet-policy-service bot added dotnet-fundamentals/svc install/subsvc community-contribution Indicates PR is created by someone from the .NET community. labels Mar 20, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Alpine installation documentation by adjusting the stated runtime dependency list to reflect what’s presumed to be present in Alpine base images.

Changes:

  • Updated ms.date to 03/20/2026.
  • Removed several packages (ca-certificates, libgcc, libssl3, and libstdc++) from the Alpine 3.20+ dependency list.

Comment on lines 76 to 80
### 3.20+

- ca-certificates
- libgcc
- libssl3
- libstdc++
- zlib (.NET 8 only)
- icu-libs and icu-data-full (unless the .NET app is running in [globalization-invariant mode](../runtime-config/globalization.md#invariant-mode))
- tzdata
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The dependency list under ### 3.20+ no longer includes ca-certificates, libgcc, libssl3, or libstdc++, but this page is referenced for manual installs/self-contained apps (not just the runtime-deps Docker images). On a minimal Alpine install those packages aren't guaranteed to be present, and missing libssl3/C++ runtime libs can prevent dotnet from starting or break TLS. Please restore these packages in the list, or explicitly scope the guidance to the official .NET Alpine base images and add a separate note for bare Alpine installs.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Indicates PR is created by someone from the .NET community. dotnet-fundamentals/svc install/subsvc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants