Fleet deployment

Install NeuraFrame Studio™ across many machines at once and license the whole fleet from one place. You buy a pool of seats once, get a single enrollment token, and every machine that installs with that token draws a license from the pool. No per-device email or checkout, and the whole fleet renews as one subscription.

1. Buy seats and create your organization

Sign in to your account and open the Fleet tab.

  1. Choose a plan (monthly or annual) and the number of seats (up to 99 self-serve), then check out. The subscription quantity is your seat count.
  2. Name your organization. You get an enrollment token that looks like ORG-xxxxxxxx.
  3. The Fleet tab now shows seats used vs bought, the token to copy, and every device in your fleet grouped by site.

Need more than 99 devices, or an air-gapped deployment with invoice billing? Contact us for an enterprise token.

2. Get the fleet tools

Download the fleet tools and unzip them on a control node (your laptop or a jump box with SSH access to the fleet). You also need the device package for your architecture from the download page (server = x86_64, jetson = ARM64).

3. Install the fleet (choose one)

SSH push (turnkey, one command for the rack)

Edit fleet.json with your package path, enrollment token, and host list, then:

python3 nf_fleet.py --config fleet.json --check    # test connectivity first
python3 nf_fleet.py --config fleet.json            # install + enroll the fleet
python3 nf_fleet.py --config fleet.json --status   # license status per host

Hosts can be listed in the config or in a separate file passed with --hosts hosts.txt (one [user@]host[:port] per line). Set completion_url and embedding_url in the config to point the whole fleet at a shared model host.

One-line bootstrap (cloud-init, kickstart, golden image)

Each machine runs a single command that downloads the package and installs plus enrolls:

curl -fsSL https://neuraframestudio.com/fleet/bootstrap.sh \
  | sudo NF_ENROLL_TOKEN=ORG-xxxx NF_PKG_URL=https://pub-92906fa0ef614aa99c8e512e79279224.r2.dev/neuraframe-studio-server-0.3.0.tar.gz bash

Ansible (slot into your existing automation)

cd ansible
cp inventory.example.ini inventory.ini      # add your hosts
ansible-playbook -i inventory.ini neuraframe.yml \
  --extra-vars "nf_enroll_token=ORG-xxxx nf_package=../neuraframe-studio-server-0.3.0.tar.gz"

4. Enroll a machine that is already installed

If NeuraFrame Studio™ is already installed on a device, join it to the fleet with:

neuraframe enroll --token ORG-xxxx

5. Manage the fleet

Enrollment is node-locked per device just like a single license, so a token cannot be used to exceed your seat count. A device that installs beyond the seat limit is told to add seats rather than being silently licensed.