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.

Bake the install command into the image, never an already enrolled agent. Every clone of an enrolled image would share one device key and keep knocking each other offline.

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.