Skip to main content
Remote share publishes a host session through the authenticated Fly.io relay so another device can attach. Wrapper negotiates a DTLS WebRTC data channel by default and keeps the relay for signaling and fallback.
Remote sharing requires Pro (can_share_relay).

​
Share from the host

  1. Sign in on the host: wrapper auth login.
  2. Run wrapper share (or share from a running host with Ctrl+\ then s).
  3. Confirm you have a shared session (wrapper status).
Unshare and revoke access with Ctrl+\ then u, or by ending the host shell.

​
Join as the owner

Owners can attach from any signed-in device without the share code:

​
Join as a guest

Guests need the session id and share code:
Enter the code in the hidden prompt. Codes are case-insensitive. Knowing the session id alone is not enough.
--code exists only for non-interactive automation. Command-line arguments can appear in process listings and shell history. Prefer the hidden prompt.

​
What guests can do

Watching is the default.
  • Read all terminal output.
  • Cannot type unless the host allows it (Ctrl+\ then w, or wrapper share --writable).
  • Resize; the host uses the smallest connected viewer size.
The person who owns the session can always type, including from their phone. Treat share codes as capabilities. When the terminal rings (BEL, or wrapper notify from inside the wrapped shell), Wrapper can ping the owner’s phone. The alert names the session. It does not include what is on screen. Opt out with WRAPPER_NOTIFY=0.

​
Transport behavior

If ICE cannot form a direct channel, the session stays on relay. If an open P2P channel drops, Wrapper waits briefly for recovery, then falls back to relay. Force relay-only:
See Transports.

​
Access model (summary)

  • Backend stores only the SHA-256 of the share code.
  • Relay tickets are random, hashed at rest, short-lived, and single-use.
  • Unsharing clears the hash and invalidates unused viewer tickets.
  • Failed guesses are rate limited without revealing whether a session exists.
Details: Security and privacy.

​
Upgrade to Pro

Pro is 99peryear(99 per year (8.25 / month) or $15 per month. Yearly is the featured price. Pick the interval on dashboard billing after sign-in. See Pricing.
Last modified on September 14, 2026