Before you start
- The Stack is deployed. Versions appear after the platform records changes to deployed add-ons or manifests; a Stack that exists only as a draft has none.
- To restore, a role with
clusters.operateon the cluster. Anyone who can open the Stack can read its history; without that permission the page says “Your role needs clusters.operate to restore a version.” - Know what a restore does not do. It does not restore database or volume data. To get data back, restore a restore point.
Restore an earlier version
1
Open the Stack's history
Open Infrastructure → Clusters → <your cluster> → Stacks (under Technical details), open the Stack, and select More → History and rollback (
/next/clusters/<cluster-id>/stacks/<stack>/history).The page reads Review changes and restore a version. If it says No resource versions recorded, nothing deployed in this Stack has changed yet.2
Pick the resource
Under Resource history, choose the add-on or manifest in Resource.The table lists its recorded versions, newest first, with Date, Changed by, Part (which part of the resource the version records) and Review. The page reads up to 100 recorded versions; that is how many it shows, not how many Ankra keeps. Protected values are hidden.
3
Review a version and compare it
Select Review version on the version you want back. Review and the resource’s name opens below, with the Selected version beside the Comparison version: the next older version of the same part, picked for you.Change Compare with to compare against any other recorded version, or No comparison to read the selected one on its own.
4
Restore it
Select Review restore. The dialog Restore and the resource’s name says what happens: the recorded version replaces the resource’s current definition and dependencies, configuration and metadata in that version are restored together, and deployment starts. Type the resource’s name to confirm, then select Restore version.The page shows Restore accepted: “The platform recorded the restore.”
5
Follow the deployment
Select Follow deployment operations to open the cluster’s Operations, and check the resource before you rely on it.
Read the history from the CLI or MCP
-o json prints it for scripts. Restoring a recorded version is a portal action. From an AI client connected to Ankra’s MCP server, get_stack_history reads who changed what and when, per resource, and rollback_addon rolls an add-on back to a previous deployment version (MCP tools).
Verify
On the cluster’s Operations, the deployment the restore started has finished. Open the Stack again: the resource shows the restored definition. From the CLI,ankra cluster stacks history my-stack shows the resource’s latest changes.
What can go wrong
Next steps
- Create and change a stack - the draft, review and deploy loop for forward fixes.
- Backups and restore points - get a Stack’s data back.
- Operations - follow what a deployment did.