Skip to content

iOS: addplanet Universal Link opens ZeroTier One but no import prompt appears #2599

Description

@yeapllg

Environment

  • Device: iPhone
  • iOS version: iOS 26.x
  • ZeroTier One iOS version: latest App Store version
  • Planet type: custom binary planet file

Problem

The documented mobile custom planet import flow does not work on iOS.

I generated a URL like:

https://joinzt.com/addplanet?v=1&planet=

On desktop Firefox, joinzt.com successfully renders a "Join ZeroTier" page with a QR code and says it will add a ZeroTier planet.

On iPhone:

  1. Scanning the QR code with the iOS Camera opens Safari.
  2. Safari shows the "Open in ZeroTier One" banner.
  3. Tapping "Open" launches ZeroTier One.
  4. ZeroTier One shows no prompt and does not import/save the planet.

I also tried:

  • Opening the joinzt.com/addplanet URL directly in Safari
  • Scanning the QR code from the ZeroTier One "Add Network" QR scanner
  • zerotier://addplanet?v=1&planet=...

Results:

  • Safari Universal Link opens ZeroTier One, but no import prompt appears.
  • ZeroTier One QR scanner does nothing.
  • zerotier://addplanet is reported by Safari as an invalid address.

Expected behavior

ZeroTier One should prompt to import/save the custom planet, as described in the private root / mobile documentation.

Actual behavior

The app opens but no prompt appears and the planet is not imported.

Notes

The URL appears valid because joinzt.com on desktop renders the ZeroTier planet QR page correctly.

The desktop joinzt.com page successfully recognizes the URL and renders a "Join ZeroTier" planet QR page, so the addplanet URL appears to be valid. The failure happens after iOS hands the Universal Link to ZeroTier One.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions