Add a computer to your organisation
- On the computer, install remotxai.
- Run
remotxai up. The approve page opens in your browser. Over SSH, scan the QR code it prints. - Open the page, sign in, choose the organisation and approve the computer with your passkey. You can also approve it on your phone or any device signed in to your account. Check that the details match your terminal.
- Check the account and organisation the terminal shows. Nothing is asked when the browser
remotxai upopened hands over to the computer; otherwise the terminal asks for the computer’s login password or Touch ID, or for the account email where the system can’t ask. The terminal checks the organisation’s account code against your browser’s copy, or trusts it on first use and says so; runremotxai lock verifyon the computer to compare it with a device already in the organisation.
The computer appears under Settings, Computers, and for owners and admins under Account, Computers, with a badge: verified, waiting for approval, unverified or removed.
Approved in one tap
Section titled “Approved in one tap”When the browser you approve from can approve computers, the same Approve tap also approves the computer for the organisation, with one passkey prompt. When remotxai up opened the page in a browser on that same computer, the page fetches the computer’s check code from it directly and shows it above Add {computer}: check it matches the one remotxai up printed, then tap. Otherwise the page shows the check code next to Approve: compare it with the one remotxai up printed and tick The code on the computer matches; Approve stays off until you do. The computer is ready as soon as it finishes, with nothing waiting.
Waiting for approval
Section titled “Waiting for approval”A computer that joins an organisation after its first one shows Waiting for approval until an owner or admin approves it. Under Account, Computers, an owner or admin taps Approve on its row and confirms with a passkey. Compare the check code on the row with the one remotxai up prints on that computer and tick The code on the computer matches; Approve stays off until you do. Running remotxai up again on an enrolled computer prints the code without changing anything. The computer connects by itself a moment later; nothing needs to run on it again.
Approve works from a browser that can approve computers for every computer in the organisation, usually the one you first set the organisation up with. On any other browser the button is greyed out and says why. Everyone else sees which roles can approve it.
Owners and admins who can approve see a line such as “Studio Mac wants to join Acme” on Home and get an email, at most one per organisation every 10 minutes. If nobody could be told, remotxai up says to ask an admin.
Personal or shared
Section titled “Personal or shared”A personal computer opens for its owner only, until the owner gives someone access. A shared computer lets every owner and admin read its sessions and answer its approvals, and an admin can give members and teams access. Only an owner or admin can approve a shared computer. Run remotxai up --shared and choose Shared on the approve page. A member can’t approve a shared computer, but can ask for one that an owner or admin accepts later. To change a computer you already enrolled, convert it to shared.
Good to know
Section titled “Good to know”- A computer belongs to one organisation. To move it, run
remotxai logout, thenremotxai up. - The first computer of a new organisation needs a desktop session on it, and stays pending until you approve your first browser: Approve on my computer in the browser
remotxai upopened, while thatremotxai upis still waiting. Install on your computer has the steps. - Approving a computer happens at the browser and the computer itself. It cannot be done from the phone alone.
- To remove a computer, choose Remove from organisation on it under Account, Computers. Nothing on the machine is deleted. No device reaches it any more.