Detach-node Command

The pf9ctl detach-node command will detach a node from any cluster it is currently attached to. Detaching the node from a cluster allows the user to reattach it to another cluster. To employ this action, run the pf9ctl detach-node command. This action also supports passing a list of node IPs to detach via an additional flag. If the flag is not supplied, the command will detach the node on which it was executed.

Syntax Example

Bash
    
 
pf9ctl detach-node [flags]
Copy

All Available Commands and Flags

Bash
    
​x
 
pf9ctl detach-node --helpDetach nodes from their clusters. If no nodes are passed it will detach the node on which the command was run.​Usage:  pf9ctl detach-node [flags]​Flags:  -h, --help              help for detach-node      --mfa string        MFA token  -n, --node-ip strings   node ip address​Global Flags:      --no-prompt   disable all user prompts      --verbose     print verbose logs
Copy

Command Examples

Bash
    
 
pf9ctl detach-node✓ Loaded Config SuccessfullyStarting detaching process2021-11-08T08:35:14.1182Z INFO  Node [9cfe32a2-6518-4b63-a55b-f9a9c1148e6a] detached from cluster
Copy

Bash
    
 
#pf9ctl detach-node -n ip✓ Loaded Config SuccessfullyStarting detaching process2021-11-08T08:35:14.1182Z INFO  Node [9cfe32a2-6518-4b63-a55b-f9a9c1148e6a] detached from cluster
Copy

Bash
    
 
#pf9ctl detach-node -n ip1,ip2✓ Loaded Config SuccessfullyStarting detaching process2021-11-08T08:35:14.1182Z INFO  Node [9cfe32a2-6518-4b63-a55b-f9a9c1148e6a] detached from cluster2021-11-08T08:35:14.1182Z INFO  Node [691a9feb-6b62-4235-bf27-208a14744843   detached from cluster
Copy

Last updated on Jan 23, 2026

Was this page helpful?