Get started

Requirements

Linux, outbound 443, a correct clock, root to install.

  • Linux kernel 3.2 or newer. The agent is a static Go binary with no libc or other runtime dependency.
  • CPU: x86-64, 32-bit x86, 64-bit ARM, or 32-bit ARMv6/ARMv7 (Raspberry Pi Zero and up).
  • Outbound HTTPS (TCP 443) to api.fieldhand.dev and relay.fieldhand.dev. Nothing inbound. An HTTP proxy works; see proxy.
  • A correct clock. TLS fails when the device thinks it is 1970. Run NTP (systemd-timesyncd, chrony or busybox ntpd).
  • Root, to install the service and to open root shells.
  • About 10 MB of disk and 12 MB of RAM.

systemd or OpenRC are used when present. Without either, start fieldhand run from your own init and restart it if it exits. See compatibility for what we have tested.

Something wrong or missing on this page? Tell us.