Skip to content

docs: add libc++ prerequisite and setup troubleshooting #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bash0816 merged 2 commits into from
Oct 29, 2026
Merged

docs: add libc++ prerequisite and setup troubleshooting #45

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a04d831
docs: add libc++ prerequisite and setup troubleshooting
bash0816 Oct 29, 2026
2519674
docs: state that pkg upgrade updates all packages
bash0816 Oct 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,13 +66,40 @@ OpenCode には npm 上で別系統の配布ラインが 2 つあります。1
## Prerequisites / 前提条件

```sh
# Updates ALL installed packages (recommended by Termux) / インストール済みの全パッケージを更新します(Termux 推奨)
pkg update && pkg upgrade
pkg install glibc-repo && pkg install glibc
pkg install patchelf
pkg install patchelf libc++
pkg install llvm
```

readelf は llvm パッケージが提供します / readelf is provided by the llvm package

### If setup fails with `cannot locate symbol "_ZNSt6__ndk1..."` / セットアップが `cannot locate symbol` で失敗する場合

On first run, `opencode` may stop with an error like this:

```
opencode-termux: setup failed: Command failed: patchelf --set-interpreter ...
CANNOT LINK EXECUTABLE "patchelf": cannot locate symbol "_ZNSt6__ndk113__hash_memoryEPKvm" ...
```

This error occurs when the installed `libc++` is older than the version your `patchelf` needs. Update `libc++`, then run `opencode` again:

```sh
pkg install libc++
```

If `pkg` does not offer a newer version, switch to a current mirror with `termux-change-repo`, then run `pkg update && pkg upgrade` (this updates all installed packages, not only OpenCode's prerequisites).

初回起動で上記のようなエラーが出る場合は、インストール済みの `libc++` が `patchelf` の必要とするバージョンより古いことが原因です。`libc++` を更新してから、もう一度 `opencode` を実行してください。

```sh
pkg install libc++
```

`pkg` が新しいバージョンを見つけられない場合は、`termux-change-repo` で最新のミラーに切り替え、`pkg update && pkg upgrade` を実行してください(OpenCode に必要なパッケージだけでなく、インストール済みの全パッケージが更新されます)。

## Install / インストール

```sh
Expand Down
Loading