Attach-node Command

The attach-node CLI command binds a specified node or nodes to an existing cluster as either a Master or Worker node.

Syntax Example

pf9ctl attach-node

All Available Commands and Flags

#pf9ctl attach-node --help Attach nodes to existing cluster. One a time, multiple workers but only one master can be attached Usage: pf9ctl attach-node [flags] cluster-name Flags: -h, --help help for attach-node -m, --master-ip strings master node ip address -w, --worker-ip strings worker node ip address Global Flags: --verbose print verbose logs

Important

We have seen users who try to attach either a master or worker nodes to a cluster, without first creating a (master/worker) type cluster. This can lead to errors which can be confusing. Please ensure a cluster is up and running before attempting to attach a node.

Command Example

pf9ctl attach-node -m 172.20.7.66 -w 172.20.7.58 test-cluster ✓ Loaded Config Successfully 2021-05-26T11:58:01.9579Z INFO Worker node(s) [bf5364cf-e2fd-4500-97fb-0b01be26084f] attached to cluster 2021-05-26T11:58:03.6328Z INFO Master node(s) [615c1042-48a3-42e8-8003-ac135d12e6f4] attached to cluster

Last updated by Anagha Pamidi on Jan 26, 2026

Was this page helpful?