You can upgrade rke2 by using the installation script, or by manually installing the binary of the desired version.
Note: Upgrade the server nodes first, one at a time. Once all servers have been upgraded, you may then upgrade agent nodes.
Upgrades performed via the installation script or using our automated upgrades feature can be tied to different release channels.
latest channel is the only available channel. Once we have more releases and need to distinguish between the most recent release and the most stable release, we will add a stable channel and set it as the default.
Upgrade rke2 Using the Installation Script
To upgrade rke2 from an older version you can re-run the installation script using the same flags, for example:
curl -sfL https://get.rke2.io | sh -
This will upgrade to the most recent version in the stable channel by default.
If you want to upgrade to the most recent version in a specific channel (such as latest) you can specify the channel:
curl -sfL https://get.rke2.io | INSTALL_RKE2_CHANNEL=latest sh -
If you want to upgrade to a specific version you can run the following command:
curl -sfL https://get.rke2.io | INSTALL_RKE2_VERSION=vX.Y.Z+rke2rN sh -
Remember to restart the rke2 process after installing:
# Server nodes:
systemctl restart rke2-server
# Agent nodes:
systemctl restart rke2-agent
Manually Upgrade rke2 Using the Binary
Or to manually upgrade rke2:
- Download the desired version of the rke2 binary from releases
- Copy the downloaded binary to
/usr/local/bin/rke2for tarball installed rke2, and
/usr/binfor rpm installed rke2
- Stop the old rke2 binary
- Launch the new rke2 binary
Restarting rke2 is supported by the installation script for systemd.
To restart servers manually:
sudo systemctl restart rke2-server
To restart agents manually:
sudo systemctl restart rke2-agent