⚠️ 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-3025

RelayDeployFailedSoloError — Component

RelayDeployFailedSoloError

CodeSOLO-3025
CategoryComponent
OwnershipInfrastructure
RetryableNo

Description

Thrown when solo relay node add cannot deploy the JSON-RPC relay; the underlying failure is wrapped in cause. Deploy installs the relay Helm release, so this means that install did not succeed — for example a Helm failure, an image that cannot be pulled, misconfigured values (such as an unreachable network or mirror-node endpoint), or insufficient cluster resources.

Troubleshooting Steps

  1. Check solo logs: tail -n 100 ~/.solo/logs/solo.log
  2. Inspect relay pods: kubectl get pods -A -l app.kubernetes.io/instance=relay-
  3. Inspect Helm release: helm status -n