Connect
1
Open the app
Install Rerun from the App Store and open it. On the sign-in screen, tap Use your own server.
2
Type your address
Under Server address, type the address you open Rerun at in a browser, for example
rerun.example.com or 192.168.1.20:3000, then tap Connect. The app reopens on your install.3
Sign in
Tap Continue with email. The code goes out the way your install sends them, see Set up Supabase.
What the phone needs to reach
- The app, at the address you typed. Use
https://on the internet. Plainhttp://only works on your local network:localhost, a private address such as192.168.1.20, a.localname or a name without a dot, or a Tailscale address. On iPhone, the first time, iOS asks to let Rerun find devices on your local network: allow it. - Supabase, at the address your app is configured with (
NEXT_PUBLIC_SUPABASE_URL), with the same rule:https://, orhttp://on your local network. When that address islocalhost, as withnpx supabase start, the phone uses the machine it reached the app on, at the same port: open that port on your network. - The engine, at
RERUN_ENGINE_BROWSER_URL, only to watch a coworker’s screen.
What your install controls
Before you raise a minimum build, check who still runs an older one: your server counts, in the
app_build_days table of its database, one row per person, build and day the app called it.
| MOBILE_IOS_CUSTOM_BUILD, MOBILE_IOS_OPENCODE_BUILD | The first iPhone build that knows Custom endpoint and OpenCode connections. While they are empty, the app does not list those connections. |
What is different from Rerun Cloud
- Sign-in is by email code only: phone codes go out through Rerun Cloud, and the Apple and Google buttons answer for Rerun Cloud, not for your install.
- No push notifications: they go out through Rerun Cloud, so on your install the app never asks for them. Notifications show in the app.