Skip to main content
The Rerun app from the App Store works with your install. It asks your app for everything else it needs, so you only type one address.

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.
To go back to Rerun Cloud before you sign in, tap Use Rerun Cloud under Continue with email. Once signed in, open Preferences, tap Server, then Leave: you are signed out, and the app reopens on Rerun Cloud.

What the phone needs to reach

  • The app, at the address you typed. Use https:// on the internet. Plain http:// only works on your local network: localhost, a private address such as 192.168.1.20, a .local name 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://, or http:// on your local network. When that address is localhost, as with npx 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 Connect says when it refuses an address:

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.