Decommission-node Command

The pf9ctl decommission-node command detaches the node from the cluster, deauthorize it, and then removes it from Platform9.

Syntax Example

Bash
    
 
pf9ctl decommission-node [flags]
Copy

All Available Commands and Flags

Bash
    
​x
 
pf9ctl decommission-node --helpRemoves the host agent package and decommissions this node from the Platform9 control plane.​Usage:  pf9ctl decommission-node [flags]​Flags:  -h, --help         help for decommission-node      --mfa string   MFA token​Global Flags:      --no-prompt   disable all user prompts      --verbose     print verbose logs
Copy

Command Example

Bash
    
 
# ./pf9ctl decommission-nodeNew version found. Please upgrade to the latest version✓ Loaded Config SuccessfullyRemoving packages(Reading database ... 140475 files and directories currently installed.)Removing pf9-comms (5.4.0-979.1d99945) ...Removing pf9-kube (1.21.3-pmk.35) ...
Copy

Note: If the node was used with proxy configuration, following file needs to be deleted from the node to use without proxy or a new configuration : /etc/systemd/system/containerd.service.d/00-pf9-proxy.conf

Last updated on Jan 23, 2026

Was this page helpful?