Install and connect a Node

Node is a headless execution endpoint. It registers a machine, stays present, and can receive supported shell and PTY work through Aihper. It does not provide the Desktop workspace.

Requirements

• Linux amd64 or arm64 with outbound HTTPS
• An Aihper account, or access to a Desktop/App that can claim the Node
• Permission to install and run software on the machine

Install

curl -fsSL https://get.aihper.com/node | sh

The installer uses approved release metadata and verifies SHA-256 before replacing the binary.

Choose one connection path

• aihper login — sign in interactively, save the credential, and start in the background.
• aihper pair — show a one-time pairing card; claim it from Desktop or the App without entering the account password on the Node.
• aihper join — redeem a join code created by Desktop. Omit the code from the command line to enter it at the hidden prompt.

Check the result

aihper info
aihper doctor
aihper code

The permanent short code identifies this machine after it is connected. It is different from a one-time pairing or join code.

Keep it available

Run aihper autostart on when this Node should return after login or boot. Use aihper autostart status to verify the operating-system integration.