How do I change the name of a node in a cluster?

Brave_skykorn

New Member
Apr 1, 2026
4
1
3
So i made the stupid mistake of waiting until after i made a cluster named fellowship to name my node Gandalf. So i went into nano and corosync to just change the name of the node to Gandalf which matches and rebooted. Now there is a connection error and i am worried that i bricked my proxmox node and cluster. please help.
 
Changing the hostname of a node within an active Proxmox cluster is indeed a complex task because the node name is deeply integrated into the filesystem and corosync configuration.

If you want to perform an in-place rename, you can refer to this detailed guide: Change hostname in a productive Proxmox Ceph HCI cluster

Additionally, while the official wiki provides a method for Renaming a PVE node, it explicitly warns:

"If your node is in a cluster, where it is not recommended changing its name, adapt /etc/pve/corosync.conf so that the nodes name is changed also there."
Given these complexities and the potential risks involved with manual corosync edits, you might find it more straightforward and reliable to consider this alternative approach:
  1. Back up or migrate your VMs/containers to other nodes.
  2. Remove the node from the cluster.
  3. Perform a fresh Proxmox VE installation with the desired hostname.
  4. Join the node back to the cluster.
This way, you can ensure a clean configuration without worrying about lingering "ghost" entries in the cluster filesystem.

Hope this helps!
 
Changing the hostname of a node within an active Proxmox cluster is indeed a complex task because the node name is deeply integrated into the filesystem and corosync configuration.

If you want to perform an in-place rename, you can refer to this detailed guide: Change hostname in a productive Proxmox Ceph HCI cluster

Additionally, while the official wiki provides a method for Renaming a PVE node, it explicitly warns:


Given these complexities and the potential risks involved with manual corosync edits, you might find it more straightforward and reliable to consider this alternative approach:
  1. Back up or migrate your VMs/containers to other nodes.
  2. Remove the node from the cluster.
  3. Perform a fresh Proxmox VE installation with the desired hostname.
  4. Join the node back to the cluster.
This way, you can ensure a clean configuration without worrying about lingering "ghost" entries in the cluster filesystem.

Hope this helps!
so the issue is that i don't have any other nodes in this cluster. i should have joined a different computer to the cluster first but i didn't. so would i change the hostname to pve so the cluster works, join a different computer, remove pve and reinstall proxmox? how do i fresh install proxmox if i already have proxmox on my mini pc?
 
It seems I misunderstood your situation earlier. Because you were mentioning the corosync configuration, I assumed you were operating within a multi-node cluster environment.

If you are actually running a standalone single node, you can simply follow the official wiki instructions to rename it: https://pve.proxmox.com/wiki/Renaming_a_PVE_node

The primary files you need to modify are:
  • /etc/hosts
  • /etc/hostname
Simply replace the old node name with the new one in these files and then reboot the system. That should be enough to complete the process.
 
  • Like
Reactions: Brave_skykorn
It seems I misunderstood your situation earlier. Because you were mentioning the corosync configuration, I assumed you were operating within a multi-node cluster environment.

If you are actually running a standalone single node, you can simply follow the official wiki instructions to rename it: https://pve.proxmox.com/wiki/Renaming_a_PVE_node

The primary files you need to modify are:
  • /etc/hosts
  • /etc/hostname
Simply replace the old node name with the new one in these files and then reboot the system. That should be enough to complete the process.
i did this on the actual machine itself and it worked like a charm. thank you so much
 
  • Like
Reactions: pulipulichen