QUICK START · 1.0.1

Connect to opencode in three steps.

Run the host next to opencode, operate it from the phone, and add a relay only when you leave the LAN. Commands below use Linux x64; swap the archive name for arm64 when needed.

01

Start the host

Extract the host archive and run it. The host reads the local opencode service registration; the opencode password stays on the computer.

HOST · LINUX X64
tar xzf ocremote-host-1.0.1-linux-x64.tar.gz
cd ocremote
./ocremote start
./ocremote direct 0.0.0.0:8787
./ocremote pair

On arm64 use ocremote-host-1.0.1-linux-arm64.tar.gz. It runs in the background by default; manage it with ./ocremote status, clients and stop.

02

Install and pair the phone

Use android-arm64-v8a.apk on a real device and android-x86_64.apk on an x86_64 emulator. Open the app, tap +, then scan the host QR or paste the pairing link.

ANDROID
adb install ocremote-1.0.1-android-arm64-v8a.apk

Compare the host fingerprint before connecting. Pair codes are single-use and expire after five minutes by default. The device token is stored in Android SecureStore.

03

Add a relay only when needed

The relay is a static Go binary that forwards encrypted frames. Noise NK authentication is built in, so no extra certificate is needed to start; the relay prints no host link; the host needs only an address and port. ./ocremote relay uses the default 118.31.124.193:8443, and the phone enrolls from the pairing code.

RELAY · OPTIONAL
./ocremote-relay --data-dir ./data \
  --listen 0.0.0.0:8443 \
  --public-url ws://<PUBLIC_IP>:8443/ws

Enable the relay on the host:

HOST · RELAY ENROLL
./ocremote relay
./ocremote pair

Noise NK pins the relay public key fetched from /v1/info; authentication and host-control frames travel inside that encrypted channel. TLS remains optional: for wss://, use a public CA or install a self-signed CA in the Android system store.

The minimum connection facts.

The host listens locally by default. For a direct phone connection, bind 0.0.0.0 or a LAN address and allow TCP 8787 through the firewall.

ItemDefaultNotes
Direct port8787Phone and host on the same LAN
Relay port8443Noise NK authentication; TLS optional
Host config~/.config/ocremote/identity.json, config.json; mode 0600
Relay data./data/relay.db, relay-identity.json, admin.sock; optional tls/
Speech models~/.local/share/ocremote/models/Host SenseVoice; phone Whisper is separate