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.
- Open your existing organization and check the licensed seats available.
- Copy its enrollment token, which looks like
ORG-xxxxxxxx. - 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
- Seats: add or remove seats any time from the Fleet tab. Seat count follows your subscription quantity.
- Free a seat: deactivate a device in the portal and its seat returns to the pool.
- Organize: group devices by site or location and see status, plan, and last seen at a glance.
- Renewal: the whole fleet renews against the one organization subscription. If it lapses, devices fall into pass-through until it is restored.