CKB Light Client fails to start due to missing GLIBC and GLIBCXX versions

[Keith-CY]

A user reported an issue when launching the built-in Light Client in Neuron:

[2025-06-25T14:03:21.873Z] [info]  CKB Light Runner:config has init, skip init...
[2025-06-25T14:03:21.877Z] [info]  CKB Light Runner:ckb light node will start with rpc port 9000, with options [
  'run',
  '--config-file',
  '/home/xxxx/.config/Neuron/chains/light/mainnet/ckb_light.toml'
]
[2025-06-25T14:03:21.891Z] [info]  Monitor: Restarting ckb process success
[2025-06-25T14:03:21.893Z] [error] CKB Light Runner:run fail: /tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client)
/tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client)
/tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.32' not found (required by /tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client)
/tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found (required by /tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client)
/tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.33' not found (required by /tmp/.mount_NeuronU3Vl3N/bin/ckb-light-client)

[2025-06-25T14:03:21.894Z] [info]  CKB Light Runner:process closed

The issue appears to be caused by the bundled ckb-light-client binary depending on newer versions of libstdc++ and libc than those available in the user’s system.

Would it be possible for someone to look into this and evaluate if more compatible build can be shipped?

Also, it would be helpful to document how users encountering this issue can fix or work around it (e.g., by upgrading dependencies or adjusting system environment).

Reference: https://discord.com/channels/657799690070523914/671648403071172619/1387444315176960000

[Officeyutong]

We have updated CI environment to ubuntu22 since ubuntu20 is going to end its support, while the default glibc version of ubuntu22 is 2.35. If you want to use light client on a OS with lower glibc, you can build it manually