> Connection Modes
LAN, USB/ADB, and Cloudflare Tunnel -- how Morpheus connects your devices.
LAN (Local Network)
The default and fastest connection mode. Both devices must be on the same WiFi network. The agent listens on port 3847 and the mobile app connects directly via the local IP address.
LAN connections have the lowest latency and highest reliability. This is the recommended mode for home and office use.
USB / ADB (Android)
For Android devices, you can connect over USB using ADB port forwarding. This is useful when WiFi is unavailable or unreliable.
Setup
- Enable Developer Options and USB Debugging on your Android device.
- Connect via USB cable and authorize the computer.
- Run the port forward command:$ adb forward tcp:3847 tcp:3847
- The mobile app connects to
ws://127.0.0.1:3847.
Remote Access via Cloudflare Tunnel
PRO Remote access lets you control your machine from anywhere. The Morpheus Agent creates a Cloudflare Tunnel that proxies WebSocket traffic through Cloudflare's network.
- No port forwarding or static IP required.
- Traffic is still end-to-end encrypted — Cloudflare sees connection metadata but cannot read message contents.
- Tunnels are temporary and created on demand.
Connection Fallback Order
When connecting, the mobile app tries each mode in order and uses the first one that succeeds:
- LAN IP —
ws://192.168.x.x:3847 - USB / ADB —
ws://127.0.0.1:3847 - Cloudflare Tunnel —
wss://xxx.trycloudflare.com
This happens automatically. No manual configuration is needed unless you want to force a specific mode in settings.
Troubleshooting Connections
Firewall blocking port 3847
Ensure your firewall allows inbound connections on TCP port 3847. On macOS, you may need to allow Morpheus in System Settings → Privacy & Security → Firewall.
Devices on different subnets
Some routers isolate WiFi clients (AP isolation). Ensure both devices are on the same subnet. Guest networks typically isolate clients — use the main network instead.
ADB not detecting device
Verify USB debugging is enabled in Android Developer Options. Run adb devices to confirm the device is listed. If not, try a different USB cable or port.