yunyoo

Documentation

Install the desktop app

Last updated:Nov 8, 2026

The desktop app is where you manage cloud phones and open the viewer. On a Mac it also runs the local node.

System requirements

SystemRequirement
macOSApple silicon
LinuxARM64, as a deb or an AppImage
WindowsNo desktop app yet

Running a local node on a Mac also needs macOS 26 or later. See Local nodes.

Download

The download page is open to invited users. Enter the download password before downloading; invited users receive this password.

Install

  • macOS: open the dmg, drag yunyoo into the Applications folder, then open it from Applications. If you run it straight from the Downloads folder or the disk image, the app cannot update itself.
  • Linux (deb): run sudo apt install ./<downloaded file>.deb, then open yunyoo from the applications menu.
  • Linux (AppImage): make the file executable and run it.

Sign-in and computer binding

The first time you sign in on this computer, it is bound to your account. An account's desktop app can be used on only one computer at a time. If you sign in on another computer, you are asked to submit a request to move; you can switch once it is approved.

You can also unbind from the bound computer yourself: in account settings, open Password and security and click Unbind this computer. It takes one verification step, and you can do it at most 2 times in 30 days. After that, the next computer you sign in on is bound straight away.

Updates

A new version is installed only after its signature checks out. Regular updates download in the background and install when you quit the app or next open it. A version marked as a required update must be installed before you can keep using the app: it downloads automatically, and the app restarts after a countdown once it is installed.

Uninstall

  • macOS: quit yunyoo and drag it from Applications to the Trash.
  • Linux: remove the deb with sudo apt remove yunyoo; for the AppImage, delete the file.

If this computer runs a local node, uninstall the node on the Nodes page first; see Local nodes. If you are moving to another computer, unbind this one first.