yunyoo

Documentation

Quick start

Last updated:Nov 8, 2026

These are the steps from signing up to opening your first cloud phone. For how the parts of yunyoo fit together, see Architecture.

1. Sign up with an invite code

Sign-up is invite-only for now. Open the web console, enter your email, a password and your invite code, then enter the code from the verification email to finish. Signing up with a Google account also needs an invite code.

2. Install the desktop app

Download the desktop app from the download page. A Mac needs Apple silicon; Linux needs ARM64. See Install the desktop app.

3. Sign in and bind this computer

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

4. Set up a local node

Cloud phones run on a local node, which is your own computer:

  • Mac: the first time you open the desktop app, it checks this Mac and sets up the local node for you if everything passes. You need Apple silicon and macOS 26 or later.
  • Linux: on the Nodes page in the desktop app, open LAN nodes and click Add Linux machine. The wizard has you install the node helper on that computer, then pair, check and install.

Once the node is set up, it downloads the cloud phone system image in the background. The first download takes a while. For requirements and details, see Local nodes.

5. Buy slots

Each cloud phone takes one slot. Slots are bought by the month, and you can buy several months at once. See the pricing page for prices. Charges come out of your wallet balance, which is topped up with USDT (TRC-20) for now.

6. Create a cloud phone

On the Environments page, click New environment. Pick a model (Android 15 for now) and a version: Non-root or Root (KSU).

A cloud phone needs a proxy before it can start. You can enter the proxy while creating it, or add one on the Proxies page first and bind it later.

7. Open the viewer

Once the cloud phone has started, open it in the viewer and use it like a phone.

Next steps