Terminal fails on remote servers and older Linux distributions (GLIBC incompatibility) #8484

Closed
opened 2026-02-16 18:10:05 -05:00 by yindo · 1 comment
Owner

Originally created by @lucas-jo on GitHub (Feb 4, 2026).

Originally assigned to: @thdxr on GitHub.

Problem

When running OpenCode on remote servers (e.g., via Tailscale) or on Linux distributions with older GLIBC versions (like Ubuntu 20.04), the terminal fails to open.

Symptoms

  1. GLIBC Incompatibility: The current requires GLIBC 2.32+, causing library load failures on systems with older GLIBC versions.
  2. WebSocket Protocol Error: When accessing WebUI via HTTPS on a remote server, terminal connection fails because it attempts to connect via instead of automatically switching to .

Proposed Solution

  • Update bun-pty to 0.4.8 which has better GLIBC compatibility.
  • Automatically handle ws/wss protocol conversion for remote server connections in the terminal component.
Originally created by @lucas-jo on GitHub (Feb 4, 2026). Originally assigned to: @thdxr on GitHub. ### Problem When running OpenCode on remote servers (e.g., via Tailscale) or on Linux distributions with older GLIBC versions (like Ubuntu 20.04), the terminal fails to open. ### Symptoms 1. **GLIBC Incompatibility**: The current requires GLIBC 2.32+, causing library load failures on systems with older GLIBC versions. 2. **WebSocket Protocol Error**: When accessing WebUI via HTTPS on a remote server, terminal connection fails because it attempts to connect via instead of automatically switching to . ### Proposed Solution - Update `bun-pty` to `0.4.8` which has better GLIBC compatibility. - Automatically handle `ws/wss` protocol conversion for remote server connections in the terminal component.
yindo closed this issue 2026-02-16 18:10:05 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Feb 4, 2026):

This issue might be a duplicate of existing issues. Please check:

  • #5844: Web terminal fails when accessing via network IP instead of localhost (WebSocket protocol conversion issue)
  • #11057: Windows desktop embedded terminal does not work - WebSocket URL scheme error
  • #5685: Cannot open terminal from opencode web (GLIBC compatibility issue with bun-pty)
  • #4908: GLIBC_2.18 not found on CentOS Linux 7 (GLIBC compatibility)
  • #10828: Opencode Docker Image doesn't allow Desktop Terminal Spawning with Bun-PTY
  • #9505: Desktop app fails to start on Linux/Wayland - PTY allocation issue

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Feb 4, 2026): This issue might be a duplicate of existing issues. Please check: - #5844: Web terminal fails when accessing via network IP instead of localhost (WebSocket protocol conversion issue) - #11057: Windows desktop embedded terminal does not work - WebSocket URL scheme error - #5685: Cannot open terminal from opencode web (GLIBC compatibility issue with bun-pty) - #4908: GLIBC_2.18 not found on CentOS Linux 7 (GLIBC compatibility) - #10828: Opencode Docker Image doesn't allow Desktop Terminal Spawning with Bun-PTY - #9505: Desktop app fails to start on Linux/Wayland - PTY allocation issue Feel free to ignore if none of these address your specific case.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#8484