Relay Server

Overview

The relay server connects your iPhone to your agent. By default, both use the official public relay at Vibe Remote.com. We recommend sticking with the official relay — it runs on 3 globally distributed servers, so it works wherever you are, even when you leave your home network. You can also run your own relay for maximum privacy, on your LAN or on a public server.

LAN Relay

If you require complete privacy and want your traffic to stay entirely within your local network, you can use a LAN relay. Note that a LAN relay only works when both your iPhone and computer are on the same network — the official relay is a better choice for everyday use.

Press w (Switch Relay) in the TUI and select Local Relay (LAN). The agent will automatically start a local relay server and connect to it. Then press r to refresh the QR code and re-scan it on your iPhone to reconnect through the LAN relay.

Self-Hosted Public Relay

This is essentially the same as a LAN relay, except you deploy it on a public server so it works from any network.

Install Vibe Remote on your VPS, then run it as a relay:

curl -fsSL https://vibe-remote.com/install.sh | sh
vibe-remote relay

The relay listens on port 24384 (TCP).

HTTPS with Reverse Proxy

For production, put the relay behind a reverse proxy with TLS:

server {
    listen 443 ssl;
    server_name relay.example.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:24384;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Then configure agent and iOS app to use https://relay.example.com.

Limitations of Self-Hosted Relay

Apple Push Notifications are not available on self-hosted relays. Push notifications require APNs credentials (Apple Developer keys) tied to the official Vibe Remote app. Self-hosted relays cannot obtain these credentials. As a result, when the iOS app is in the background, you will not receive push notifications for completed tasks — the app will only update when you open it.

All other features work normally on self-hosted relays.