Relay Server

Overview

The relay server connects your iPhone to your agent. By default, both use the public relay at vibe-remote.com. You can also run your own relay — on your LAN or on a public server.

LAN Relay

If your iPhone and computer are on the same network, you can run a local relay for lower latency and full privacy.

vibe-remote relay --port 24384

Then configure both the agent and the iOS app to use the LAN relay URL:

• Agent: press r in the TUI, enter http://<your-lan-ip>:24384
• iOS app: go to Dashboard > Settings, set the relay URL to http://<your-lan-ip>:24384

Find your LAN IP with ifconfig (macOS/Linux) or ipconfig (Windows).

Note: LAN relay only works when both devices are on the same network.

Self-Hosted Public Relay

Install vibe-remote on your VPS, then run it as a relay:

curl -fsSL https://vibe-remote.com/install.sh | sh
ADMIN_PASSWORD=your-admin-password vibe-remote relay --port 24384

The relay listens on port 24384 (TCP). Set ADMIN_PASSWORD to enable the admin dashboard at /admin.

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.