Get started

Adding Nodes

How to register new bare-metal servers with your NodeFoundry cluster.

Automatic Registration

The simplest way: just power on a server with PXE boot enabled on a network where DHCP is configured to point at your master node. The server will:

  1. PXE boot and pull the OS image
  2. Start the NodeFoundry agent
  3. Report its hardware (disks, NICs, CPU, RAM) to the Sentinel
  4. Appear in nf node list with pending status
Terminal
$ nf node list

Hardware Inventory

Once registered, inspect a node’s hardware:

Terminal
$ nf disks list
Terminal
$ nf nics list

What to Do After Registration

Once nodes are registered, you can deploy Ceph daemons:

  1. Deploy monitors — nf ceph mon --node <id> --disk <id> (3 or 5 monitors)
  2. Deploy a manager — nf ceph mgr --node <id> (at least 1)
  3. Deploy OSDs — nf ceph osd --node <id> --disk <id> (one per disk)

See Deploying Ceph for a complete walkthrough.

SSH Access

Add your SSH key to access nodes directly:

Terminal
$ nf ssh add --name "my key" --key "ssh-ed25519 AAAA..."

The key is automatically distributed to all registered nodes.