Remote tunnels

Remote tunnels let OpenRemote connect to OpenCode when your phone and desktop are not on the same local network.

How it works

  • The OpenRemote plugin starts a local authenticated proxy on your desktop.
  • The proxy uses a generated password, so you do not need to configure an OpenCode server password.
  • A tunnel provider exposes that proxy through a temporary HTTPS URL.
  • The app switches to the tunnel only after the desktop and the app can both reach it.
  • While connected through a tunnel, turn remote access off only after disconnecting.

Setup

Install the OpenRemote plugin first, then choose a tunnel provider.

Restart OpenCode after setup.

Providers

cloudflared

Install Cloudflare's tunnel client on the desktop running OpenCode.

brew install cloudflared

For other platforms, use the official Cloudflare install guide.

Open OpenRemote, go to Settings, then set Remote access to cloudflare. The desktop starts a temporary tunnel and the app connects after the tunnel is reachable.

Open cloudflared install docs