Skip to content

Commit d9517c6

Browse files
committed
doc(blog): add a blog post about the upcoming glibc min version bump
1 parent 5374656 commit d9517c6

File tree

1 file changed

+55
-0
lines changed

1 file changed

+55
-0
lines changed
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: Minimum Required glibc Version Bump
3+
authors:
4+
- name: Mithril Team
5+
tags: [mithril client, cli, breaking-change]
6+
---
7+
8+
# Upcoming Change: Minimum Required glibc Version Bump
9+
10+
:::info
11+
This only affects users who rely on the **precompiled Linux binaries** provided by the Mithril team.
12+
13+
If you compile the binaries from source or use a different operating system, you are not affected by this change.
14+
:::
15+
16+
Following [the deprecation of `Ubuntu 20.04` in GitHub Actions](https://github.com/actions/runner-images/issues/11101),
17+
we are updating the minimum required glibc version for our Linux binaries from `2.31` to `2.35`.
18+
19+
## Current Situation
20+
21+
Our Continuous Integration (CI) uses GitHub Actions to build and test the Mithril binaries for different platforms.
22+
23+
Currently, our CI builders target `Ubuntu 20.04` to build Linux binaries, leading to a minimum required glibc version of
24+
`2.31`.
25+
This version is compatible with systems such as `Ubuntu 20.04` and `Debian 11 (Bullseye)`.
26+
27+
However, with the release of `Ubuntu 24.04`, GitHub Actions is dropping support for `Ubuntu 20.04` as they only support
28+
the last two LTS versions.
29+
30+
As a result, we need to update our CI environment to use a more recent version of Ubuntu.
31+
32+
## Upcoming Change
33+
34+
Distribution `2506` will be the last distribution with a minimum required glibc version of `2.31`.
35+
36+
After the release of distribution `2506`, our CI builders will be updated to use `Ubuntu 22.04`. Raising the minimum
37+
required glibc version for our Linux binaries to `2.35`.
38+
39+
## Impact on Users
40+
41+
The new glibc version `2.35` is compatible with systems such as `Ubuntu 22.04` and `Debian 12 (Bookworm)`.
42+
43+
If you are using a system with an older version of glibc, you can either:
44+
45+
- Upgrade your system to a newer version that supports glibc `2.35` to continue using our compiled binaries.
46+
- Compile the binaries from source to avoid upgrading your system.
47+
48+
## Summary
49+
50+
- **Current minimum glibc version**: `2.31`
51+
- Examples of compatible systems: `Ubuntu 20.04`, `Debian 11 (Bullseye)`
52+
- **New minimum glibc version**: `2.35` (effective **after** distribution `2506` release)
53+
- Examples of compatible systems: `Ubuntu 22.04`, `Debian 12 (Bookworm)`
54+
55+
For any inquiries or assistance, don't hesitate to contact the team on the [Discord channel](https://discord.gg/5kaErDKDRq).

0 commit comments

Comments
 (0)