Skip to content
NeuraFrame™ Studio

Fleet deployment

For existing license holders, install legacy NeuraFrame Studio™ across many machines and manage the fleet from one place. Each machine enrolled with your organization token draws a license from the existing seat pool. New legacy signups are closed.

1. Find your existing organization token

Sign in to your existing account and open the Fleet tab.

  1. Open your existing organization and check the licensed seats available.
  2. Copy its enrollment token, which looks like ORG-xxxxxxxx.
  3. The Fleet tab shows seats used, your token, and enrolled devices grouped by site.

For help with an existing fleet or offline deployment, contact support.

2. Get the fleet tools

Download the fleet tools (no longer available) 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 (no longer available) (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.5.2.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.5.2.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.