connection failed error
Open
Nobody has claimed this yet.
bug
CLI
connectivity
custom-model
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What version of Codex CLI is running?
v0.153.0
What subscription do you have?
$20 per month
Which model were you using?
gpt-5.6-terra medium
What platform is your computer?
Linux 6.8.0-136-generic x86_64 x86_64
What terminal emulator and version are you using (if applicable)?
No response
Codex doctor report
{
"schemaVersion": 1,
"generatedAt": "1788412920s since unix epoch",
"overallStatus": "fail",
"codexVersion": "0.153.0",
"checks": {
"app_server.status": {
"id": "app_server.status",
"category": "app-server",
"status": "ok",
"summary": "background server is not running",
"details": {
"control socket": "/home/rohit/.codex/app-server-control/app-server-control.sock",
"daemon state dir": "/home/rohit/.codex/app-server-daemon",
"mode": "ephemeral",
"pid file": "/home/rohit/.codex/app-server-daemon/app-server.pid (missing)",
"settings": "/home/rohit/.codex/app-server-daemon/settings.json (missing)",
"status": "not running",
"update-loop pid file": "/home/rohit/.codex/app-server-daemon/app-server-updater.pid (missing)"
},
"remediation": null,
"durationMs": 0
},
"auth.credentials": {
"id": "auth.credentials",
"category": "auth",
"status": "ok",
"summary": "auth is configured",
"details": {
"auth env vars present": "OPENAI_API_KEY",
"auth file": "/home/rohit/.codex/auth.json",
"auth storage mode": "File",
"stored API key": "false",
"stored ChatGPT tokens": "true",
"stored agent identity": "false",
"stored auth mode": "chatgpt"
},
"remediation": null,
"durationMs": 0
},
"config.load": {
"id": "config.load",
"category": "config",
"status": "ok",
"summary": "config loaded",
"details": {
"CODEX_HOME": "/home/rohit/.codex",
"config.toml": "/home/rohit/.codex/config.toml",
"config.toml parse": "ok",
"cwd": "/home/rohit",
"enabled feature flags": "shell_tool, view_image, sleep_tool, unified_exec, unified_exec_zsh_fork, shell_snapshot, content_item_kinds, code_mode_host, terminal_resize_reflow, sqlite, hooks, enable_request_compression, unbounded_connection_retries, multi_agent, apps, tool_search_always_defer_mcp_tools, tool_suggest, plugins, in_app_browser, in_app_chat, in_app_dictation, in_app_local_automation, in_app_updates, browser_use, browser_use_full_cdp_access, browser_use_external, computer_use, remote_plugin, plugin_sharing, image_generation, resize_all_images, item_ids, skill_mcp_dependency_install, skill_search, mentions_v2, steer, guardian_approval, goals, collaboration_modes, tool_call_mcp_elicitation, auth_elicitation, personality, fast_mode, tui_app_server, remote_compaction_v2, compaction_image_budget, workspace_dependencies",
"feature flag overrides": "none",
"feature flags enabled": "47",
"log dir": "/home/rohit/.codex/log",
"mcp servers": "2",
"model": "gpt-5.6-terra",
"model provider": "headroom",
"sqlite home": "/home/rohit/.codex"
},
"remediation": null,
"durationMs": 0
},
"git.environment": {
"id": "git.environment",
"category": "git",
"status": "ok",
"summary": "git version 2.34.1",
"details": {
"PATH git #1": "/usr/bin/git",
"PATH git #2": "/bin/git",
"PATH git entries": "2",
"git build options": "git version 2.34.1; cpu: x86_64; no commit associated with this build; sizeof-long: 8; sizeof-size_t: 8; shell-path: /bin/sh",
"git exec path": "/usr/lib/git-core",
"git version": "git version 2.34.1",
"repo detected": "false",
"selected git": "/usr/bin/git"
},
"remediation": null,
"durationMs": 35
},
"installation": {
"id": "installation",
"category": "install",
"status": "ok",
"summary": "installation looks consistent",
"details": {
"PATH codex #1": "/home/rohit/.nvm/versions/node/v18.18.2/bin/codex",
"PATH codex #2": "/home/rohit/.local/bin/codex",
"PATH codex entries": "2",
"current executable": "/home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin/codex",
"install context": "npm (package /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl, bin /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin, resources /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/codex-resources, path /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/codex-path)",
"managed by Vite+": "false",
"managed by bun": "false",
"managed by npm": "true",
"managed by pnpm": "false",
"managed package root": "/home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex",
"npm update target": "/home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex"
},
"remediation": null,
"durationMs": 164
},
"mcp.config": {
"id": "mcp.config",
"category": "mcp",
"status": "ok",
"summary": "MCP configuration is locally consistent",
"details": {
"configured servers": "2",
"disabled servers": "0",
"stdio servers": "2"
},
"remediation": null,
"durationMs": 0
},
"network.env": {
"id": "network.env",
"category": "network",
"status": "ok",
"summary": "network-related environment looks readable",
"details": {
"managed proxy": "not configured",
"proxy env vars": "none",
"respect system proxy": "disabled"
},
"remediation": null,
"durationMs": 0
},
"network.provider_reachability": {
"id": "network.provider_reachability",
"category": "reachability",
"status": "fail",
"summary": "one or more required provider endpoints are unreachable over HTTP",
"details": {
"headroom API inference URL": "http://127.0.0.1:8787/v1/<redacted> connect failed (required)",
"reachability mode": "ChatGPT auth"
},
"remediation": "Check proxy, VPN, firewall, DNS, and custom CA configuration.",
"durationMs": 34
},
"network.websocket_reachability": {
"id": "network.websocket_reachability",
"category": "websocket",
"status": "warning",
"summary": "Responses WebSocket failed; HTTPS fallback may still work",
"details": {
"DNS": "1 IPv4, 0 IPv6, first IPv4",
"auth mode": "chatgpt",
"connect timeout": "15000 ms",
"endpoint": "ws://127.0.0.1:8787/v1/<redacted>",
"handshake transport error": "network error: Connection refused (os error 111)",
"model provider": "headroom",
"provider name": "OpenAI via Headroom proxy",
"proxy env vars": "none",
"supports websockets": "true",
"wire API": "responses"
},
"remediation": "Check proxy, VPN, firewall, DNS, custom CA, and WebSocket policy support.",
"durationMs": 75
},
"runtime.provenance": {
"id": "runtime.provenance",
"category": "runtime",
"status": "ok",
"summary": "running npm on linux-x86_64",
"details": {
"commit": "unknown",
"current executable": "/home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin/codex",
"install method": "npm (package /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl, bin /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin, resources /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/codex-resources, path /home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/codex-path)",
"platform": "linux-x86_64",
"version": "0.153.0"
},
"remediation": null,
"durationMs": 0
},
"runtime.search": {
"id": "runtime.search",
"category": "search",
"status": "ok",
"summary": "search is OK (bundled)",
"details": {
"search command": "/home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/codex-path/rg",
"search command readiness": "file exists",
"search provider": "bundled"
},
"remediation": null,
"durationMs": 0
},
"sandbox.helpers": {
"id": "sandbox.helpers",
"category": "sandbox",
"status": "ok",
"summary": "sandbox configuration is readable",
"details": {
"approval policy": "OnRequest",
"codex-linux-sandbox helper": "/home/rohit/.codex/tmp/arg0/codex-arg0tAbZIj/codex-linux-sandbox",
"execve wrapper helper": "/home/rohit/.codex/tmp/arg0/codex-arg0tAbZIj/codex-execve-wrapper",
"filesystem sandbox": "restricted",
"network sandbox": "restricted"
},
"remediation": null,
"durationMs": 0
},
"security.endpoint": {
"id": "security.endpoint",
"category": "security",
"status": "ok",
"summary": "endpoint protection is not inspected on this platform",
"details": {
"endpoint products": "not inspected on this platform"
},
"remediation": null,
"durationMs": 0
},
"state.paths": {
"id": "state.paths",
"category": "state",
"status": "ok",
"summary": "state paths and databases are inspectable",
"details": {
"CODEX_HOME": "/home/rohit/.codex (dir)",
"active rollout files": "21 files, 10957449 total bytes, 521783 average bytes",
"archived rollout files": "0 files, 0 total bytes, 0 average bytes",
"goals DB": "/home/rohit/.codex/goals_1.sqlite (file)",
"goals DB integrity": "ok",
"log DB": "/home/rohit/.codex/logs_2.sqlite (file)",
"log DB integrity": "ok",
"log dir": "/home/rohit/.codex/log (dir)",
"memories DB": "/home/rohit/.codex/memories_1.sqlite (file)",
"memories DB integrity": "ok",
"queue DB": "/home/rohit/.codex/queue_1.sqlite (file)",
"queue DB integrity": "ok",
"sqlite home": "/home/rohit/.codex (dir)",
"state DB": "/home/rohit/.codex/state_5.sqlite (file)",
"state DB integrity": "ok",
"thread history DB": "/home/rohit/.codex/thread_history_1.sqlite (file)",
"thread history DB integrity": "ok"
},
"remediation": null,
"durationMs": 46
},
"state.rollout_db_parity": {
"id": "state.rollout_db_parity",
"category": "threads",
"status": "warning",
"summary": "rollout files and state DB thread inventory differ",
"details": {
"default model provider": "headroom",
"rollout DB active files": "17",
"rollout DB active rows": "17",
"rollout DB archive mismatches": "0",
"rollout DB archived files": "0",
"rollout DB archived rows": "0",
"rollout DB duplicate DB paths": "0",
"rollout DB duplicate rollout thread ids": "0",
"rollout DB malformed file names": "0",
"rollout DB missing active rows": "0",
"rollout DB missing archived rows": "0",
"rollout DB model providers": "headroom=17",
"rollout DB rows": "17",
"rollout DB scan cap reached": "false",
"rollout DB scan error sample": [
"/home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T18-25-32-a1469bbb-b11a-469b-9dfe-f4c360657d64.jsonl (rollout at /home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T18-25-32-a1469bbb-b11a-469b-9dfe-f4c360657d64.jsonl has no usable header record)",
"/home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T18-24-56-42afc716-72b6-4ece-9375-4b2baaa2b7e1.jsonl (rollout at /home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T18-24-56-42afc716-72b6-4ece-9375-4b2baaa2b7e1.jsonl has no usable header record)",
"/home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T09-04-46-dc0e0023-bfd8-4339-a840-5b430fdba2f4.jsonl (rollout at /home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T09-04-46-dc0e0023-bfd8-4339-a840-5b430fdba2f4.jsonl has no usable header record)",
"/home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T09-55-25-2c623499-fa83-4cf3-8065-6f0d1fdcbcfd.jsonl (rollout at /home/rohit/.codex/sessions/2025/08/03/rollout-2025-08-03T09-55-25-2c623499-fa83-4cf3-8065-6f0d1fdcbcfd.jsonl has no usable header record)"
],
"rollout DB scan errors": "4",
"rollout DB sources": "cli=17",
"rollout DB stale rows": "0"
},
"issues": [
{
"severity": "warning",
"cause": "rollout scan was incomplete or found bad files",
"measured": "4 scan errors, 0 malformed names, scan cap reached: false",
"expected": "rollout directories are fully scannable",
"remedy": "Check file permissions and unexpected files under CODEX_HOME sessions.",
"fields": []
}
],
"remediation": null,
"durationMs": 39
},
"system.disk": {
"id": "system.disk",
"category": "disk",
"status": "ok",
"summary": "sufficient free disk space (24.8 GiB)",
"details": {
"CODEX_HOME available": "24.8 GiB",
"failure threshold": "1.0 GiB",
"warning threshold": "5.0 GiB",
"worktree available": "24.8 GiB"
},
"remediation": null,
"durationMs": 0
},
"system.environment": {
"id": "system.environment",
"category": "system",
"status": "ok",
"summary": "OS language en-US",
"details": {
"EDITOR": "not set",
"LANG": "en_US.UTF-8",
"VISUAL": "not set",
"os": "Ubuntu 22.4.0 (jammy) [64-bit]",
"os language": "en-US",
"os type": "Ubuntu",
"os version": "22.4.0"
},
"remediation": null,
"durationMs": 39
},
"terminal.env": {
"id": "terminal.env",
"category": "terminal",
"status": "ok",
"summary": "terminal metadata was detected",
"details": {
"COLORTERM": "truecolor",
"DISPLAY": "present",
"WAYLAND_DISPLAY": "present",
"color output": "enabled",
"effective locale": "en_US.UTF-8",
"stderr is terminal": "true",
"stdin is terminal": "true",
"stdout is terminal": "true",
"terminal": "GNOME Terminal",
"terminal size": "120x36"
},
"remediation": null,
"durationMs": 0
},
"terminal.title": {
"id": "terminal.title",
"category": "title",
"status": "ok",
"summary": "terminal title default",
"details": {
"terminal title activity": "true",
"terminal title items": "activity, project-name",
"terminal title project source": "cwd",
"terminal title project value": "rohit",
"terminal title source": "default"
},
"remediation": null,
"durationMs": 0
},
"updates.status": {
"id": "updates.status",
"category": "updates",
"status": "ok",
"summary": "update configuration is locally consistent",
"details": {
"cached latest version": "0.153.0",
"check for update on startup": "true",
"last checked at": "2026-09-03T05:05:13.723310487Z",
"latest version": "0.153.0",
"latest version status": "current version is not older",
"npm update target": "/home/rohit/.nvm/versions/node/v18.18.2/lib/node_modules/@openai/codex",
"update action": "npm install -g @openai/codex",
"version cache": "/home/rohit/.codex/version.json"
},
"remediation": null,
"durationMs": 778
}
}
}
What issue are you seeing?
connection failed error
What steps can reproduce the bug?
Uploaded thread: 01a065ab-e54e-7960-a5a1-a6022d2a329a
What is the expected behavior?
No response
Additional information
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Codex doctor report's network.provider_reachability and network.websocket_reachability checks, which both show connection refusal at the local Headroom proxy endpoint. Reproduce the failure on Linux with the reported configuration, then determine and document a project-side fix that makes the required provider endpoint reachable; no source file or test is identified in the issue.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli, networking
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100