Private pilot. By invitation.Request access

Node Lodge
Request access

Providers · Agent

Pair a machine in minutes.

Compute Host: one file, a standard user, no open port.

Open the console How it works
compute-host
$ node compute-host.mjs doctor --api https://nodelodge.com$ node compute-host.mjs inventory$ node compute-host.mjs enroll --api https://nodelodge.com --code 7KQ2-M9XH-4TPA$ node compute-host.mjs run

Step by step

Install and pair.

Requires Node 22 or later, and a provider account.

  1. 01

    Generate a pairing code

    In the console: Machines, then Pair a machine. Name it. The code is single use and expires in 15 minutes.

  2. 02

    Get the agent

    One file. Windows PowerShell, not as administrator. The console gives this command with the checksum filled in.

    PowerShell
    PS> $d="$HOME\ComputeHost"; New-Item -ItemType Directory -Force $d | Out-Null; Set-Location $dPS> Invoke-WebRequest https://nodelodge.com/downloads/compute-host.mjs -OutFile compute-host.mjs -UseBasicParsingPS> (Get-FileHash .\compute-host.mjs -Algorithm SHA256).Hash# compare with the SHA-256 shown in the console
  3. 03

    Check the machine

    Read-only self-test: privileges, GPU, inventory, API, clock. Nothing is changed.

    terminal
    $ node compute-host.mjs doctor --api https://nodelodge.com
  4. 04

    Preview the report

    Exactly what will be sent. Printed locally.

    terminal
    $ node compute-host.mjs inventory
  5. 05

    Pair

    A key pair is generated on the machine. Only the public half is sent.

    terminal
    $ node compute-host.mjs enroll --api https://nodelodge.com --code 7KQ2-M9XH-4TPAEnrolled as host 3f0c8f5e (status: pending_approval). Key fingerprint: 9b1e04c7d2a85f36
  6. 06

    Keep it reporting

    Heartbeats every 30 seconds, outbound only. Leave it running.

    terminal
    $ node compute-host.mjs run

Commands.

doctor [--api <url>] [--json]
Read-only self-test.
inventory
Show detected hardware. Sends nothing.
enroll --api <url> --code <code>
Pair this machine with your provider account.
run [--once]
Send heartbeats and inventory updates.
status
Show the local enrollment.
forget
Delete the local identity. Revoke the machine in the console too.

No provider account?

Choose “List my own machines” in the request.

Request access Sign in