|
| 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