Skip to content

Installing an XCore

What to cover

  • Supported hardware (Intel NUC BOXNUC7i5BNK + newer).
  • Imaging a USB installer, verifying checksum.
  • First boot: LUKS passphrase (Path B full-disk + clevis-tpm2), BIOS settings, boot order.
  • Network: static vs. DHCP, verifying outbound to cloud.xcentrix.net and frps tunnel on port 7000.
  • Running provision.sh: what it does (SSH keys, systemd services, docker compose stack).
  • Enrolling the XCore with a tenant from the cloud admin portal.
  • First-boot smoke tests: MQTT auth, cloud tunnel visible, dashboard shows the controller online.
  • Known first-boot issues — cross-reference memory/xcore-first-boot-issues.md.