Support

I got an invite. What do I do?

Open the invite link on your phone. If you don't have Ovenlight yet, the link opens a page that shows where to get it. Install it, then open the link again. When Ovenlight shows who invited you and to which app, tap Join. You don't need an account. If you have Ovenlight but the link opens a web page, tap Open in Ovenlight there. On iPhone, if that opens the page again, tap Copy Invite, then open Ovenlight, choose Join with Invite (under More, if you already use Ovenlight) and tap Paste. You were shown a QR code? Scan it with your phone's camera, or open Ovenlight, choose to join with an invite, and scan the code there.

An invite works once, on one phone, and expires after 7 days. A group link works for up to 10 phones for 3 days. If yours was used or has expired, ask for a new one.

The app says it can't reach the computer

Each app runs on its owner's own computer, not on our servers, so it opens live only while that computer is on, awake and online. Meanwhile, from version 1.1.0, Ovenlight shows a read-only copy of what you last saw, marked "Copy from" and a time at the top, if your phone keeps one. It does for apps from Ovenlight connector 1.2.0 or later: your own unless you turned Keep Warm off for them, and a shared app when the person who shared it allows it. The connector updates itself unless the computer's owner turned updates off. Check that your phone is online, then tap Try Again. If it still doesn't open, the computer is probably asleep or off, so let the person who shared the app know.

If it's your own computer, make sure it's awake (a Mac also needs to be logged in to its desktop), then run ovenlight doctor on it. It lists anything wrong and how to fix it. If you still need help, email us what it prints. Before you send it, remove any login or invite link, since whoever opens one first can get into that app.

An app disappeared, or Ovenlight says it's no longer shared with you

The person who shared the app stopped sharing it with you, or stopped running it. When that happens, the next time Ovenlight connects it removes the app and everything it stored on your phone. If you think it was a mistake, ask them for a new invite. Apps shared with you don't move to a new or restored phone either, so ask for a new invite there.

How do I leave an app someone shared with me?

In Ovenlight, tap the More button at the top right, then Settings, and tap Leave next to their name under Shared with you. You can also leave from the app's menu. Leaving removes all of that person's apps and everything they stored on your phone, and you'll need a new invite to open them again. They still see you in their list until they remove you.

How do I report a problem with a shared app?

A shared app is run by the person who shared it, on their own computer. Snowy Ghost doesn't host or run it, and can't see inside it. For anything about how the app itself works, choose Send Feedback to (their name) from the app's menu. Your note goes to the person who runs it, with a screenshot unless you turn that off.

To tell us about a problem, including an app you think is harmful, choose Report a Problem from the app's menu, or by touching and holding its icon. It starts an email to us and fills in the app's name and address, who shared it, how its connection is doing, your Ovenlight version and your phone's iOS or Android version (on Android, also its WebView version and model). Add what happened, and send it when you're ready. You can also leave the app at any time.

Ovenlight locks too often, or not at all

Ovenlight locks after it has been in the background for the time you choose at the top of Settings: Immediately, or after 1, 5 or 15 minutes (1 minute unless you change it). It also locks after your phone restarts, and can't lock until your phone has a passcode or screen lock. Choose Off to stop it locking at all: it asks for your phone's unlock first.

Ovenlight asks me to update Android System WebView

On Android, Ovenlight needs Android System WebView 144 or later. Tap Open Google Play on the update screen, update Android System WebView there, then open Ovenlight again.

How do I share a link or text into an app?

From version 1.1.0, share it from another app and choose Ovenlight in the share sheet. On iPhone, Ovenlight may be under More, and once you choose it you tap Done and open Ovenlight yourself. Pick the app, and Ovenlight opens it with what you shared. Only apps that take what you're sharing are listed, so an app that takes only links won't show for plain text. If one you expect is missing, ask whoever runs it: the app needs to take shares of that kind, and an app the Ovenlight connector serves needs the connector at 1.2.0 or later. What you share goes only to that app's computer, and whoever runs the app can read it. Before it goes to an app someone shared with you, Ovenlight asks you.

How do I set up my own computer?

The people you share with only install Ovenlight on their phone. You're the one running the apps, so you need a computer that stays on and awake while anyone uses them: a Mac with macOS 13 or later (kept logged in), a Linux computer with systemd (such as Ubuntu), or a Windows 11 PC. A laptop sleeps when you close its lid until you change one setting. Windows puts an idle PC to sleep by default, so in Settings, under System > Power (Power & battery on a laptop), set sleep to Never. You also need a Tailscale account. Tailscale's free Personal plan is for non-commercial use, so a business needs one of Tailscale's paid plans. Want your apps up all the time? Run them on your own server: a computer at home that stays on, such as a Mac mini or a spare PC, or a cloud server you rent.

  1. In the Tailscale admin console, under DNS, turn on MagicDNS if it's off, then turn on HTTPS certificates.
  2. Install the connector. On a Mac or Linux, run this in a terminal:

    curl -fsSL https://ovenlight.app/install.sh | sh

    On Windows, sign in as the account that will own the apps, which must be an administrator. Open PowerShell with Run as administrator, then run:

    irm https://ovenlight.app/install.ps1 | iex

    Never used a terminal? Here's how to open one. When the script is done, open a new terminal window. On Linux, if it prints a sudo loginctl enable-linger command, run that too, so the connector keeps serving with nobody logged in and after a restart.

    To check the download yourself first, or install without the script, see Install by hand.

  3. Publish an app. With your coding agent (Claude Code, Codex and others), connect it and ask it to put your app on your phone. To publish it yourself, run your app so it serves plain HTTP on 127.0.0.1, and static files from a public folder only, never the project's folder with its data and code. Then publish it with its port, for example ovenlight publish --port 4317 --name "Notes". To have the connector keep it running instead, stop your copy and publish again from the app's folder, adding --run with the command that starts it. No app yet? ovenlight new "Family List" --dir ~/src writes a starter app and says how to run and publish it.
  4. Open the login link that publish prints, or that your agent passes on, and sign in with your Tailscale account. If your tailnet has device approval on, also approve the app, listed by its slug (such as notes), on the admin console's Machines page.
  5. Install Ovenlight on your phone from the App Store or Google Play. In it, choose Use My Own Computers (if you've already joined someone's app, it's under the More button, then Settings), tap Connect, and sign in with the same account. If Tailscale or Ovenlight says the phone needs approval, approve the device it names on the Machines page too. Your apps then appear on their own.

Signed in, but your apps don't appear? The phone must use the same Tailscale account as your computers. In Settings, Advanced shows which Tailscale account and tailnet the phone is on. If it's on another account, tap Sign Out in Settings and follow step 5 again with the right account.

ovenlight doctor checks the setup and gives a fix for each problem it finds. To share an app, store a Tailscale API access token with ovenlight auth set, make the app shareable with ovenlight publish --slug notes --shareable, then touch and hold the app in Ovenlight and choose Share.

The connector's documentation covers updating, moving to a new computer and uninstalling. It ends with troubleshooting and a list of every command.

I removed one of my own apps. How do I get it back?

An app you remove doesn't come back on its own. Tap the More button, then Add App, and enter its address. ovenlight status on its computer lists each app's address.

A friend can't open an app I shared

Your computer must be on and awake while they use it, and a Mac must also be logged in to its desktop. Each invite works once and expires after 7 days (a group link works for up to 10 phones for 3 days), so if theirs was used or has expired, touch and hold the app and choose Share to send a new one.

What is Pilot Light, and how do I manage it?

Pilot Light is Ovenlight's paid feature, for people who run apps on their own computer. While your computer sleeps, your apps open with what changed before it slept, even on a phone that wasn't open then. People you invite by name can open theirs before they join. Ovenlight can notify you and the people you share an app with when your computer asks it to, and you hear when your computer can't be reached. The people you share with don't need it. If you sign in to someone else's Tailscale account in Ovenlight on a phone with your subscription, their computers get Pilot Light too, and keep it for as long as your subscription lasts. You'll find it in Ovenlight: tap the More button at the top right, then Settings. Choose Use My Own Computers if you haven't, then open Settings again and tap Pilot Light. You manage and cancel it with the store you bought it from, the App Store or Google Play. The connector's documentation explains the sleep alert and its quiet hours.

Does Snowy Ghost see my data?

No server of ours carries your apps or their data, except what an app's owner sends through Pilot Light, sealed so only the phones it's meant for can open it (or, for a starter copy, anyone holding its invite link). Your apps run on your computers or your friends', and Ovenlight connects to them over a private, encrypted connection that doesn't pass through any server of ours. The app has no ads, tracking or analytics code. The only things that reach us are emails you choose to send, what Apple or Google passes on (such as crash reports and test feedback), what an app's owner sends through Pilot Light's relay and phones' own requests to it, and the ordinary request when a page on ovenlight.app loads, when you download the connector, or when the connector checks for and downloads its updates. The privacy policies for iPhone and Android have the details.

Contact us

Email team@snowyghost.com and a human will reply. You can also start that email from Ovenlight: tap the More button at the top right, then Settings, and tap Contact Us. It fills in your Ovenlight version, your phone's iOS or Android version (on Android, also its WebView version and model) and, if you use your own computers, how their connection is doing.