Skip to content

Customer onboarding

Fabrizio Degni edited this page Nov 16, 2026 · 6 revisions

Customer onboarding

Open NodeLift Account to set up a personal workspace and its devices. This is an invite-only, operator-approved pilot. The customer portal has its own account/MFA boundary and uses Hive directly; the Mac is not a required execution controller.

First device

If you forgot your password, use Forgot password? below Sign in. Follow the recovery guide: the pilot uses an operator-assisted private link after identity verification. Existing Authenticator remains required. No recovery email is sent. Sessions and developer keys expire after success; devices and clusters remain enrolled.

  1. Accept an account invitation, choose a password of at least eight characters and wait for operator approval. Invitation email delivery and public signup are not enabled.
  2. Sign in and choose a session duration of nine hours, seven days or thirty days. Configure your own Authenticator. Account MFA is mandatory before managing or using devices; recovery is operator-assisted.
  3. Select the personal workspace and cluster. The portal creates their initial identities idempotently. Use Create another cluster only when you want a separate logical group.
  4. Install the companion appropriate to the actual OS/architecture. Read the official release notes and signing limits. A download click does not prove installation.
  5. Create a device invitation for the selected cluster. Scan the QR in the companion or use the supported same-device nodelift://pair link. Return to the portal and type the eight-character code displayed in that companion. Confirm that you recognize the device. Until then, model preparation and work remain blocked.
  6. Enable participation in the companion and explicitly save its Hive operating schedule. Set the timezone and days/time range, or consciously choose all-day availability. Battery, thermal, resource and device-local consent limits continue to apply.
  7. In Check readiness, resolve the actual blocker. Prepare the declared model and keep the companion active. Contact alone is not runtime readiness.
  8. Choose the ready worker and exact model, write a prompt and explicitly run the first task. Inspect real progress, output and available timings. A successful task is Completed through Hive, an authenticated worker result, not independently established model quality or hardware attestation.

Add another device to this cluster, or create/select another cluster and repeat. The workspace/cluster selectors define the active scope. They do not combine physical RAM or make a large model executable across several phones.

If setup stops

Observation Action
Pending approval Wait for the pilot operator and refresh approval state. No verification email is promised.
Authenticator required Configure it for this customer account or sign in with a fresh six-digit code. The operator's Hive MFA does not grant customer access.
Fresh sign-in required Sign out and authenticate again. MFA setup/verification needs password authentication within fifteen minutes.
QR or confirmation expired Create a fresh invitation and pair again using the same installed companion. These grants expire after five minutes.
Old confirmation format Update the companion, create a fresh QR and pair again. The new code is derived from private enrollment material, not the public node ID.
Unrecognized pending device Do not confirm it. Revoke it and create a new invitation.
Connected, but participation/model/worker missing Open the companion, resume it, enable consent and prepare the selected model. Match the worker's actual model SHA-256.
Outside operating hours Correct the explicit schedule, or deliberately permit a one-off task. That exception does not bypass device consent/readiness.
Energy unavailable Check freshness, source permissions and the source's scope. Disconnect charging power for battery-discharge sampling. An unsupported sensor remains unavailable.
Hive unavailable Retry later. The portal preserves the durable scope and does not fabricate setup progress or output.

The confirmation code is temporary device-comparison material, not an additional account MFA factor, a global hardware identity or hardware attestation. Read it from the intended companion; do not publish it or accept one forwarded by another person.

Platform and energy limits

Android uses the official ARM64 APK and still requires OS installation consent. iOS/iPadOS unsigned packages require personal Apple signing and installation from a Mac; Safari, TestFlight and the App Store are not configured installation routes for this pilot. Windows portable packages include their runtime: extract the full matching-architecture archive, not a source/quick-update kit. Current Windows previews do not bundle an LLM backend and are not physical GPU qualification. HarmonyOS NEXT and Xbox have separate preview/source restrictions.

Measured and estimated energy are displayed separately, with their available source/window coverage. Battery-terminal, CPU/GPU component and whole-device readings have different meanings. Neither a partial sum nor battery percentage proves task energy, energy savings or whole-cluster consumption. iOS public APIs do not provide the needed direct W/J measurements.

This customer route runs one complete supported model on a ready worker. It does not implement pooled RAM, distributed model partitioning or demonstrated acceleration. The new multi-device customer onboarding path has not yet been physically qualified across all supported platforms; frontend/unit checks and earlier operator-flow measurements are separate evidence.

See the full implementation/API and verification guide, desktop package matrix, official releases and mobile downloads.

Executed rollout evidence distinguishes real HTTPS/Linux execution from pending physical mobile qualification.

Account invitations

Hive owners can open Users → Invitations to manage one-use account invitations, validity, revocation and separate email-submission states. SMTP must be configured before creation is enabled. The selected mailbox is active; private SMTP configuration and external delivery qualification remain pending. See the complete invitation guide.

Clone this wiki locally