Get started
Enroll a whole fleet
One token, up to 500 devices, run on first boot of your image.
In Add devices, choose A golden image and how long units may sit before their first boot: 30 days, 90 days or a year. The token works for up to 500 installs. Type tags in Tag new devices (for example site:austin customer:acme) and every unit it installs gets them. Run the install command on the first boot of each unit:
# /etc/systemd/system/fieldhand-enroll.service [Unit] Description=Enroll this unit with Fieldhand After=network-online.target Wants=network-online.target ConditionPathExists=!/etc/fieldhand/agent.json [Service] Type=oneshot ExecStart=/bin/sh -c 'curl -fsSL https://api.fieldhand.dev/install.sh | sh -s -- --token fhe_…' Restart=on-failure RestartSec=30 [Install] WantedBy=multi-user.target
The ConditionPathExists line makes it run only until the unit is enrolled. Restart=on-failure retries while the network is still coming up. With cloud-init, put the same command under runcmd.
Anyone who copies the image can enroll a device into your workspace until the token runs out. When a batch is done, or if an image leaks, revoke the token under Add devices → Install tokens still active. Devices it already enrolled keep working.
Names
Each unit appears under its hostname. If all units share a hostname, pass a unique name, for example from the serial number:
--name "kiosk-$(cat /sys/class/dmi/id/product_serial 2>/dev/null || cat /etc/machine-id | cut -c1-8)"
Then use tags to group units by site, customer or hardware revision.
Something wrong or missing on this page? Tell us.