Olares

English

简体中文

English

简体中文

Appearance

Common issues ​

Terminal does not accept input on ARM64 devices ​

The terminal panel loads but does not respond to keyboard input.

This happens because the terminal depends on bun-pty, which requires glibc. The OpenCode container is based on Alpine Linux (musl libc), so bun-pty cannot load the native PTY library on ARM64 devices.

Workaround: Use the OpenCode container's terminal in Control Hub instead.

Page goes blank with a CDN error ​

The page suddenly goes blank, and the browser console shows TypeError: ot(...) is not a function.

OpenCode loads frontend resources from a CDN (app.opencode.ai) at runtime instead of bundling them locally. When the CDN deploys a broken frontend version, all users are affected.

To resolve this:

  1. Hard-refresh your browser with Ctrl+Shift+R or Cmd+Shift+R.
  2. If the issue persists, wait for the CDN to deploy a hotfix.
  3. Check the upstream repository for fix progress.

Plan mode fails unexpectedly ​

Plan mode loads frontend resources from the same CDN as the main UI. A CDN-side bug can cause Plan mode to fail even if your local installation is up to date.

To resolve this:

  1. Hard-refresh your browser.
  2. Check the upstream repository for known issues or newer releases.

Some packages fail to install ​

The OpenCode container runs on Alpine Linux, which uses musl libc instead of glibc. Packages that require a glibc-based environment, such as certain Node.js native modules or Python packages with C extensions, might not install or run correctly.

Use pkg-install for system-level packages where possible. See Manage packages for details.

Cannot edit provider details in the Models panel ​

The Models panel only supports toggling connected models on or off. You cannot edit provider configurations directly from this panel.

To update a provider's settings:

  • Disconnect the provider, then reconnect it with the updated details.
  • Alternatively, edit the config file directly and restart OpenCode. See Edit the config file for instructions.

WebFetch fails intermittently ​

The WebFetch tool might occasionally fail to retrieve content from certain URLs. These failures are typically caused by the target website's availability or network conditions rather than OpenCode itself.

If WebFetch fails repeatedly:

  1. Retry the request after a short wait.
  2. Check whether the target URL is accessible from your browser.
  3. Try a different URL if the target site is temporarily unavailable.