Repository navigation
[Bug] T3 Connect: Relay environment endpoint unavailable on CachyOS x86_64 #7139
Description
Activity
- changed the title
[-]T3 Connect: Relay environment endpoint unavailable on CachyOS x86_64[/-][+](Bug) T3 Connect: Relay environment endpoint unavailable on CachyOS x86_64[/+]on Aug 15, 2026 - changed the title
[-](Bug) T3 Connect: Relay environment endpoint unavailable on CachyOS x86_64[/-][+][Bug] T3 Connect: Relay environment endpoint unavailable on CachyOS x86_64[/+]on Aug 15, 2026 Can confirm this exact behavior on CachyOS x86_64 (
7.2.3-1-cachyos) runningt3code.serviceundersystemd --user.What is actually happening (Root Cause):
This is not a CachyOS/kernel incompatibility, but a port desync in the T3 Connect relay lifecycle:
- The local server is healthy:
Locally on the box,t3 serveis running andcurl -i http://127.0.0.1:<port>/returns HTTP 200 with the full web app. - The Cloudflare tunnel is connected:
cloudflared tunnel runis actively connected to Cloudflare edge locations with QUIC. - The port desync:
Whent3code.servicestarts or restarts,t3 servepicks an ephemeral/dynamic loopback port (e.g.3773) if none is explicitly specified.
However, the managed Cloudflare Tunnel / T3 Connect relay link routes incoming traffic to whatever local port was registered whent3 connect linkwas run.
When the service restarts or the port changes, incoming requests forwarded through the relay hit a dead local port (ECONNREFUSED), returning a 502 to the relay, which surfaces in the client as:
Relay environment endpoint is unavailable: endpoint_request_failed.
Temporary Workarounds:
- Re-run
npx t3 connect linkon the box so the relay receives the current port. - Or pin the port in
~/.config/systemd/user/t3code.serviceby adding--port <port>toExecStart.
This is directly related to #7458 and should be resolved by PR #8353 (
fix(server): use listener port for managed tunnel origins).- The local server is healthy:
Thanks for taking the time to report this and provide the details. We revisited it during the orchestrator V2 cleanup.
The specific port-desynchronization cause supplied in the latest comment is addressed: startup derives the origin from the actual listening address.port and registers managed-tunnel recovery using that origin.
I’m closing this based on the current source and the evidence in this thread.
Original generic endpoint_request_failed can have other causes; closure applies to the diagnosed stale-port case, not every relay failure.
If you still hit this on a current build, please reply with the app/server versions and the steps that reproduce it. We can reopen this if the original problem is still there.
Summary
T3 Code on CachyOS x86_64 fails to connect to remote environments with error:
'Failed to connect. Reconnecting... Reason: Relay environment endpoint is unavailable: endpoint_request_failed'
Trace ID: d24b28efla30909a7d1dbfd3444da762
Environment
Steps to Reproduce
Troubleshooting Already Attempted
Additional Context
Request
Investigate relay environment endpoint availability for CachyOS x86_64 platforms.
Consider platform-specific relay configuration or provide guidance on resolving inconsistent T3 Connect state after re-authentication.
--
This issue was filed from opencode session regarding T3 Connect relay endpoint failure on CachyOS.