⚠️ Homebrew support is being deprecated. Solo will stop publishing updates to Homebrew after August 31, 2026. Install via npm install -g @hiero-ledger/solo@latest instead. See System Readiness for full install instructions.

SOLO-2026

BackupRestoreClustersFailedSoloError — Deployment

BackupRestoreClustersFailedSoloError

CodeSOLO-2026
CategoryDeployment
OwnershipInfrastructure
RetryableNo

Description

Thrown when solo config ops restore-clusters cannot recreate the clusters captured in a backup; the underlying failure is wrapped in cause. This step reads the backup archive and rebuilds the cluster(s) it describes (for example recreating a Kind cluster) before the rest of a restore can proceed, so the error means that rebuild failed. Common roots are an invalid or incomplete backup archive, an incorrect input directory, or Docker/Kind not being available to create the clusters.

Troubleshooting Steps

  1. Check solo logs: tail -n 100 ~/.solo/logs/solo.log
  2. Verify the backup archive is valid and the input directory is correct
  3. Check Docker or Kind cluster availability: kind get clusters
  4. Run cluster restore: solo config ops restore-clusters