Documentation

Upgrade the agent

Use the maintenance-first path to move an existing node to a newer agent version.

Try StackShiftRead the overview

Nodes

Upgrade the agent

Live

Use the maintenance-first path to move an existing node to a newer agent version.

Goal

Update the node agent without leaving it in a confused scheduling state.

Current status

Live

This area is documented as current, user-reliable behavior.

Workflow

  1. 1Put the node into maintenance.
  2. 2Apply the upgrade command or reinstall flow.
  3. 3Verify heartbeat freshness and version state before returning the node to service.

How the upgrade path is framed

  • StackShift exposes copyable upgrade commands from the node page.
  • Maintenance mode is the expected safety gate before upgrading.
  • The UI distinguishes “upgrade available” from a real failed upgrade operation.

Expected result

The node reports the expected agent version and can safely leave maintenance.