Install reports libwebkit2gtk-4.1.so.0 is missing - cc-switch

Quick fix

Installing the rpm on Rocky 9 fails on a missing webkit dependency. Upgrading the system to Rocky 10.1 resolves it.

Symptom

Error outputCopy

安装提示缺少libwebkit2gtk-4.1.so.0

English translation

Install reports libwebkit2gtk-4.1.so.0 is missing

Cause

Installing cc-switch from the rpm package on Rocky 9 fails outright because the official system repositories do not carry the libwebkit2gtk-4.1.so.0 dependency. Separately, some Windows users cannot find an installer on the Releases page, usually because they did not expand the Assets list, or hit a scope problem with winget.

Fix

1. 1

   Upgrade the operating system to Rocky 10.1 or newer.

2. 2

   Once upgraded, download the rpm package again and install cc-switch with it.

Affected Versions

Toolcc-switch

VersionUnknown

PlatformsLinuxWindows

Source Issues

This page is distilled from 5 real issues

• #354releases页面看不到安装包啊
• #837rocky9系统安装失败
• #1097现在怎么下载release windows 安装包找不到啊
• #1524为什么找不到windows的安装包，只有其他俩系统的
• #5762[撤回/Withdrawn] winget scope 问题（本地已解决，误发）

FAQ

I cannot find an installer for Windows on the Releases page. What now?

Expand the Assets list under the version you want (v3.10.3, for example). If you hit a scope problem installing through winget, download the MSI installer by hand and upgrade with that.

Related problems

Cannot install or update Codex CC SwitchUpgrade to v3.16.3+ and reinstall/update Codex from 设置 → 关于 (Settings > About); if v3.16.5 still fails, report it with logs.2 issues mergederror code is 2503 or icon turns white after upgradeRemove Icon="ProductIcon" from per-user-main.wxs to fix install errors and missing icons. Existing users must unpin and repin.2 issues mergedopenclaw.json is not valid JSON - OpenClawAdd double quotes around the models key in ~/.openclaw/openclaw.json by hand to fix the strict JSON parse failure.3 issues merged