Skip to content
xNet / Docs

Connect to xNet Cloud

After you subscribe at xnet.fyi/cloud, xNet Cloud provisions a dedicated, always-on hub for your data. Your apps still hold the plaintext — the hub only ever stores encrypted updates and relays them between your devices. This guide links an app to that hub.

You can open the relevant steps any time from the Connect your apps card on your dashboard.

Two identities, one account

Section titled “Two identities, one account”

xNet keeps the who pays and whose data questions separate on purpose:

  • Billing identity — the email you sign in to the dashboard with. Custodial and recoverable (a normal password/passkey reset).
  • Data identity (your passkey) — a did:key created on your device when you first open the app. Non-custodial: it never leaves the device, and it’s what proves a device may read and write your data. We never see its private key.

Connecting a device is the moment these two are bound together: you prove the billing side (you’re signed in to the dashboard) and the data side (your app holds the passkey) at the same time.

Connect your app

Section titled “Connect your app”
  1. Open the web app (or click Open web app on your dashboard).
  2. When prompted, create your passkey. This is your data identity — it stays on your device.
  3. Choose Connect xNet Cloud hub. The app shows a short code like ABCD-7K2P.
  4. On your dashboard, open Connect your apps → Enter a code, type the code, and approve. The app finishes connecting automatically.

What the device code is

Section titled “What the device code is”

The short code is a standard device authorization flow — the same pattern you’ve used to sign a TV or a CLI into an account:

sequenceDiagram
  participant App as Your app
  participant Cloud as xNet Cloud
  participant You as You (dashboard)
  App->>Cloud: I'm did:key:… — start a connection
  Cloud-->>App: Show code ABCD-7K2P
  You->>Cloud: Approve ABCD-7K2P (you're signed in)
  loop until approved
    App->>Cloud: Is ABCD-7K2P approved yet?
  end
  Cloud-->>App: Approved — here's your hub URL
  App->>App: Connect & sync

The code is short-lived (about 10 minutes). If it expires, just restart the connection from your app to get a fresh one.

Troubleshooting

Section titled “Troubleshooting”
  • “Code not found or expired.” Codes last ~10 minutes. Restart Connect xNet Cloud hub in your app for a new one, then enter it promptly.
  • Desktop app won’t connect after pasting the URL. Make sure you pasted the full wss://… hub URL into Signaling server, then fully restart the app. You still need to create your passkey and approve a code — pasting the URL alone only points the app at the hub.
  • Hub shows “Sleeping” on the dashboard. Cold hubs wake on the next connection; give it a few seconds after your app reconnects.
  • Still stuck? See the pricing FAQ or check the status page.
Section titled “Related”