Error Codes
Complete reference for all Solo error codes, including troubleshooting steps and ownership classification.
All Solo errors carry a structured code, an ownership classification, and troubleshooting steps. Click an error code to see its dedicated page.
Configuration
| Code | Class | Ownership | Retryable |
|---|---|---|---|
| SOLO-1001 | LocalConfigNotFoundSoloError | User | No |
| SOLO-1002 | WriteLocalConfigFileError | Infrastructure | No |
| SOLO-1003 | RefreshLocalConfigSourceError | Infrastructure | No |
| SOLO-1004 | RemoteConfigsMismatchSoloError | Infrastructure | No |
Deployment
| Code | Class | Ownership | Retryable |
|---|---|---|---|
| SOLO-2001 | CreateDeploymentSoloError | Infrastructure | Yes |
| SOLO-2002 | DeploymentAlreadyExistsSoloError | User | No |
| SOLO-2003 | DeploymentNotFoundError | User | No |
| SOLO-2004 | DeploymentHasRemoteResourcesError | User | No |
| SOLO-2005 | DeploymentDeleteFailedError | Infrastructure | Yes |
| SOLO-2006 | ClusterAddFailedError | Infrastructure | Yes |
| SOLO-2007 | DeploymentListFailedError | Infrastructure | Yes |
| SOLO-2008 | ClusterReferenceNotFoundError | User | No |
| SOLO-2009 | ClusterReferenceAlreadyExistsError | User | No |
| SOLO-2010 | NamespaceNotSetError | User | No |
| SOLO-2011 | NoClustersForDeploymentError | User | No |
| SOLO-2012 | ClusterReferenceResolutionFailedError | Solo | No |
| SOLO-2013 | ContextNotFoundForClusterError | User | No |
| SOLO-2014 | NoDeploymentsFoundError | User | No |
| SOLO-2015 | DeploymentListPortsFailedError | Infrastructure | Yes |
| SOLO-2016 | ClusterSetupFailedSoloError | Infrastructure | No |
| SOLO-2017 | ClusterResetFailedSoloError | Infrastructure | No |
| SOLO-2018 | MinioInstallFailedSoloError | Infrastructure | No |
| SOLO-2019 | PrometheusInstallFailedSoloError | Infrastructure | No |
| SOLO-2020 | MetricsServerInstallFailedSoloError | Infrastructure | No |
| SOLO-2021 | ClusterRoleInstallFailedSoloError | Infrastructure | No |
| SOLO-2022 | ClusterApiServerTimeoutSoloError | Infrastructure | Yes |
| SOLO-2023 | KindClusterNetworkSetupFailedSoloError | Infrastructure | No |
| SOLO-2024 | BackupExportFailedSoloError | Infrastructure | No |
| SOLO-2025 | BackupImportFailedSoloError | Infrastructure | No |
| SOLO-2026 | BackupRestoreClustersFailedSoloError | Infrastructure | No |
| SOLO-2027 | DeployNetworkFailedSoloError | Infrastructure | No |
| SOLO-2028 | InitFailedSoloError | Infrastructure | No |
| SOLO-2029 | BlockNodeClusterContextNotFoundSoloError | User | No |
| SOLO-2030 | MirrorNodeClusterContextNotFoundSoloError | User | No |
Component
| Code | Class | Ownership | Retryable |
|---|---|---|---|
| SOLO-3001 | NodeTransactionFailedSoloError | Infrastructure | No |
| SOLO-3003 | NodeBuildUploadFailedSoloError | Infrastructure | Yes |
| SOLO-3004 | NodeBuildCopyFailedSoloError | Infrastructure | Yes |
| SOLO-3005 | NodeJfrExecutionFailedSoloError | Infrastructure | Yes |
| SOLO-3006 | NodeJfrPidNotFoundSoloError | Solo | No |
| SOLO-3007 | NodeDebugArchiveFailedSoloError | Solo | No |
| SOLO-3008 | BlockNodeConfigFailedSoloError | Infrastructure | Yes |
| SOLO-3009 | ChartInstallFailedSoloError | Infrastructure | Yes |
| SOLO-3010 | NetworkDestroyFailedSoloError | Infrastructure | No |
| SOLO-3011 | NodeNotReadySoloError | Infrastructure | No |
| SOLO-3012 | RapidFireExecutionSoloError | Infrastructure | Yes |
| SOLO-3013 | NodeStakeTransactionErrorSoloError | Infrastructure | Yes |
| SOLO-3014 | NodePrepareUpgradeTransactionErrorSoloError | Infrastructure | Yes |
| SOLO-3015 | NodeFreezeUpgradeTransactionErrorSoloError | Infrastructure | Yes |
| SOLO-3016 | NodeFreezeTransactionErrorSoloError | Infrastructure | Yes |
| SOLO-3017 | NodeUpdateTransactionErrorSoloError | Infrastructure | No |
| SOLO-3018 | NodeDeleteTransactionErrorSoloError | Infrastructure | No |
| SOLO-3019 | NodeCreateTransactionErrorSoloError | Infrastructure | No |
| SOLO-3021 | AccountBalanceQueryFailedSoloError | Infrastructure | Yes |
| SOLO-3022 | ExplorerDeployFailedSoloError | Infrastructure | No |
| SOLO-3023 | ExplorerUpgradeFailedSoloError | Infrastructure | No |
| SOLO-3024 | ExplorerDestroyFailedSoloError | Infrastructure | No |
| SOLO-3025 | RelayDeployFailedSoloError | Infrastructure | No |
| SOLO-3026 | RelayUpgradeFailedSoloError | Infrastructure | No |
| SOLO-3027 | RelayDestroyFailedSoloError | Infrastructure | No |
| SOLO-3028 | RelayNotRunningSoloError | Infrastructure | Yes |
| SOLO-3029 | RelayNotReadySoloError | Infrastructure | Yes |
| SOLO-3030 | RelayOperatorKeyRetrievalFailedSoloError | Infrastructure | Yes |
| SOLO-3031 | MirrorNodeDeployFailedSoloError | Infrastructure | No |
| SOLO-3032 | MirrorNodeUpgradeFailedSoloError | Infrastructure | No |
| SOLO-3033 | MirrorNodeDestroyFailedSoloError | Infrastructure | No |
| SOLO-3034 | MirrorNodeOperatorKeyRetrievalFailedSoloError | Infrastructure | Yes |
| SOLO-3035 | OneShotDeployFailedSoloError | Infrastructure | No |
| SOLO-3036 | OneShotDestroyFailedSoloError | Infrastructure | No |
| SOLO-3037 | OneShotDeploymentInfoRetrievalFailedSoloError | Infrastructure | No |
| SOLO-3038 | FalconValuesPreparationFailedSoloError | Infrastructure | No |
| SOLO-3039 | BlockNodeDeployFailedSoloError | Infrastructure | No |
| SOLO-3040 | BlockNodeDestroyFailedSoloError | Infrastructure | No |
| SOLO-3041 | BlockNodeUpgradeFailedSoloError | Infrastructure | No |
| SOLO-3042 | BlockNodeAddExternalFailedSoloError | Infrastructure | No |
| SOLO-3043 | BlockNodeDeleteExternalFailedSoloError | Infrastructure | No |
| SOLO-3044 | BlockNodeHealthCheckFailedSoloError | Infrastructure | Yes |
| SOLO-3045 | RapidFireLoadStartFailedSoloError | Infrastructure | Yes |
| SOLO-3046 | RapidFireLoadStopFailedSoloError | Infrastructure | No |
| SOLO-3047 | RapidFireKillFailedSoloError | Infrastructure | No |
| SOLO-3048 | AccountCreationFailedSoloError | Infrastructure | No |
| SOLO-3049 | AccountKeyUpdateFailedSoloError | Infrastructure | No |
| SOLO-3050 | AccountKeysBatchUpdateFailedSoloError | Infrastructure | No |
| SOLO-3051 | AccountTransferFailedSoloError | Infrastructure | No |
| SOLO-3052 | AccountInfoFailedSoloError | Infrastructure | No |
| SOLO-3053 | AccountUpdateFailedSoloError | Infrastructure | No |
| SOLO-3054 | AccountSecretCreationFailedSoloError | Infrastructure | No |
| SOLO-3055 | EvmAddressRetrievalFailedSoloError | Infrastructure | No |
| SOLO-3056 | NodeAccessConfigFailedSoloError | Infrastructure | No |
| SOLO-3057 | NodeClientLoadFailedSoloError | Infrastructure | No |
| SOLO-3058 | NodeClientRefreshFailedSoloError | Infrastructure | No |
| SOLO-3059 | NodeClientSetupFailedSoloError | Infrastructure | No |
| SOLO-3060 | SdkPingFailedSoloError | Infrastructure | Yes |
| SOLO-3061 | NodeServicesRetrievalFailedSoloError | Infrastructure | No |
| SOLO-3062 | GossipKeySecretCreationFailedSoloError | Infrastructure | No |
| SOLO-3063 | TlsKeySecretCreationFailedSoloError | Infrastructure | No |
| SOLO-3064 | TlsKeyGenerationFailedSoloError | Infrastructure | No |
| SOLO-3065 | SigningKeyGenerationFailedSoloError | Infrastructure | No |
| SOLO-3066 | GrpcTlsKeyGenerationFailedSoloError | Infrastructure | No |
| SOLO-3067 | GrpcTlsCertMismatchSoloError | User | No |
| SOLO-3068 | GrpcWebTlsCertMismatchSoloError | User | No |
| SOLO-3069 | CertificateSecretCreationFailedSoloError | Infrastructure | No |
| SOLO-3070 | CertificateParsingFailedSoloError | User | No |
| SOLO-3071 | CertificateFileNotFoundSoloError | User | No |
| SOLO-3072 | ExplorerTlsSecretCreationFailedSoloError | Infrastructure | No |
| SOLO-3073 | PlatformFileNotFoundSoloError | Infrastructure | No |
| SOLO-3074 | PlatformFileCopyFailedSoloError | Infrastructure | No |
| SOLO-3075 | PlatformKeyFileMissingSoloError | Infrastructure | No |
| SOLO-3076 | GenesisAdminKeySecretFailedSoloError | Infrastructure | No |
| SOLO-3077 | GenesisDataGenerationFailedSoloError | Infrastructure | No |
| SOLO-3078 | PostgresInitScriptCopyFailedSoloError | Infrastructure | No |
| SOLO-3079 | PostgresInitScriptFailedSoloError | Infrastructure | Yes |
| SOLO-3080 | MirrorPasswordSecretMissingSoloError | Infrastructure | No |
| SOLO-3081 | FileContentVerificationFailedSoloError | Infrastructure | No |
| SOLO-3082 | HederaFileCreationFailedSoloError | Infrastructure | No |
| SOLO-3083 | HederaFileUpdateFailedSoloError | Infrastructure | No |
| SOLO-3084 | HederaFileAppendFailedSoloError | Infrastructure | No |
| SOLO-3085 | NodeStatusEmptyResponseSoloError | Infrastructure | No |
| SOLO-3086 | NodeStatusMissingLineSoloError | Infrastructure | No |
| SOLO-3087 | PredefinedAccountsCreationFailedSoloError | Infrastructure | No |
| SOLO-3088 | FileContentMismatchSoloError | Infrastructure | No |
| SOLO-3089 | NodeServiceNotFoundSoloError | User | No |
Validation
| Code | Class | Ownership | Retryable |
|---|---|---|---|
| SOLO-4001 | MissingArgumentError | User | No |
| SOLO-4002 | IllegalArgumentError | User | No |
| SOLO-4003 | InvalidOutputFormatError | User | No |
| SOLO-4004 | ConsensusNodeCountRequiredError | User | No |
| SOLO-4005 | InvalidPortNumberError | User | No |
| SOLO-4006 | LocalBuildPathNotFoundSoloError | User | No |
| SOLO-4007 | LocalBuildMissingSubdirectoriesSoloError | User | No |
| SOLO-4008 | LocalBuildNoJarFilesSoloError | User | No |
| SOLO-4009 | NodeJarFilesNotInContainerSoloError | Solo | No |
| SOLO-4010 | GrpcEndpointsRequiredSoloError | User | No |
| SOLO-4011 | OutputDirectoryNotSpecifiedSoloError | User | No |
| SOLO-4012 | InputDirectoryNotSpecifiedSoloError | User | No |
| SOLO-4013 | WrapsKeyPathNotFoundSoloError | User | No |
| SOLO-4014 | ConfigFileNotFoundSoloError | User | No |
| SOLO-4015 | NodeVersionMismatchSoloError | User | No |
| SOLO-4016 | UpgradeVersionNotFoundSoloError | User | No |
| SOLO-4017 | PvcFlagNotEnabledSoloError | User | No |
| SOLO-4018 | NonInteractivePromptSoloError | User | No |
| SOLO-4019 | RealmShardVersionConstraintSoloError | User | No |
| SOLO-4020 | WrapsVersionConstraintSoloError | User | No |
| SOLO-4021 | StateFilePathNotFoundSoloError | User | No |
| SOLO-4022 | StateFileNotFoundSoloError | User | No |
| SOLO-4023 | InvalidStateFileFormatSoloError | User | No |
| SOLO-4024 | InvalidStateZipFileNameSoloError | User | No |
| SOLO-4025 | ExplorerInvalidComponentIdSoloError | User | No |
| SOLO-4026 | RelayInvalidComponentIdSoloError | User | No |
| SOLO-4027 | OneShotCachedDeploymentNotFoundSoloError | User | No |
| SOLO-4028 | MirrorNodeInvalidComponentIdSoloError | User | No |
| SOLO-4029 | BlockNodeLocalImageNotFoundSoloError | User | No |
| SOLO-4030 | BlockNodeInvalidComponentIdSoloError | Solo | No |
| SOLO-4031 | BlockNodePlatformVersionTooLowSoloError | User | No |
| SOLO-4032 | BlockNodeLivenessPortVersionIncompatibleSoloError | User | No |
| SOLO-4033 | InvalidHbarAmountSoloError | User | No |
| SOLO-4034 | InvalidFileIdFormatSoloError | User | No |
| SOLO-4035 | InvalidEndpointFormatSoloError | User | No |
| SOLO-4036 | InvalidCommaSeparatedStringSoloError | User | No |
| SOLO-4037 | InvalidConfigNumberValueSoloError | User | No |
| SOLO-4038 | InvalidStorageTypeSoloError | User | No |
| SOLO-4039 | UnsupportedFlagFieldTypeSoloError | Solo | No |
| SOLO-4040 | VersionDowngradeBlockedSoloError | User | No |
| SOLO-4041 | AdminKeysCountMismatchSoloError | User | No |
| SOLO-4042 | ComponentAlreadyExistsSoloError | Solo | No |
| SOLO-4043 | ComponentIdRequiredSoloError | Solo | No |
| SOLO-4044 | ComponentNotFoundSoloError | Solo | No |
| SOLO-4045 | ComponentNotInRemoteConfigSoloError | Solo | No |
| SOLO-4046 | UnknownComponentTypeSoloError | Solo | No |
| SOLO-4047 | ConfigFileInvalidSoloError | User | No |
| SOLO-4048 | MultipleClustersFoundSoloError | User | No |
| SOLO-4049 | CacheNotMaterializedSoloError | User | No |
| SOLO-4050 | CacheImageTemplateUnknownSoloError | User | No |
| SOLO-4051 | InvalidKindNodeImageSoloError | User | No |
| SOLO-4052 | PathTraversalDetectedSoloError | User | No |
| SOLO-4053 | NodeAliasesMustBeArraySoloError | Solo | No |
| SOLO-4054 | UnknownNodeAliasSoloError | User | No |
| SOLO-4055 | NodeAliasInferenceFailedSoloError | User | No |
| SOLO-4056 | NodeAliasParseFailedSoloError | User | No |
| SOLO-4057 | DomainNameParseFailedSoloError | User | No |
| SOLO-4058 | UnknownTemplateDependencySoloError | Solo | No |
| SOLO-4059 | NoConsensusNodesFoundSoloError | User | No |
| SOLO-4060 | ServiceTypeMismatchSoloError | Infrastructure | No |
| SOLO-4061 | BackupConfigNotFoundSoloError | User | No |
| SOLO-4062 | BackupConfigInvalidSoloError | User | No |
| SOLO-4063 | BackupConfigReadFailedSoloError | Infrastructure | No |
| SOLO-4064 | BackupConfigMapKeyMissingSoloError | Infrastructure | No |
| SOLO-4065 | BackupConfigParseFailedSoloError | Infrastructure | No |
| SOLO-4066 | BackupInputDirectoryNotFoundSoloError | User | No |
| SOLO-4067 | BackupNoClusterDirectoriesSoloError | User | No |
| SOLO-4068 | BackupClusterValidationFailedSoloError | User | No |
| SOLO-4069 | BackupNoClusterInfoSoloError | User | No |
| SOLO-4070 | BackupNoComponentsSoloError | User | No |
| SOLO-4071 | BackupOptionsFileNotFoundSoloError | User | No |
| SOLO-4072 | BackupZipFileRequiredSoloError | User | No |
| SOLO-4073 | BackupInputPathNotFoundSoloError | User | No |
| SOLO-4074 | BackupInputMustBeZipSoloError | User | No |
| SOLO-4075 | BackupNoLogFilesSoloError | User | No |
| SOLO-4076 | FlagInputFailedSoloError | User | No |
System
| Code | Class | Ownership | Retryable |
|---|---|---|---|
| SOLO-5001 | ResourceNotFoundError | Infrastructure | No |
| SOLO-5002 | ClusterConnectionFailedError | Infrastructure | Yes |
| SOLO-5003 | PortForwardRefreshFailedError | Infrastructure | Yes |
| SOLO-5004 | PortForwardStatusFailedError | Infrastructure | Yes |
| SOLO-5005 | NamespaceNotFoundSoloError | User | No |
| SOLO-5006 | PodNotFoundSoloError | Infrastructure | Yes |
| SOLO-5007 | HaproxyPodsNotFoundSoloError | Infrastructure | Yes |
| SOLO-5008 | LoadBalancerNotFoundSoloError | Infrastructure | Yes |
| SOLO-5009 | KubeContextNotFoundSoloError | Solo | No |
| SOLO-5010 | ConsensusNodeNotInConfigSoloError | Solo | No |
| SOLO-5011 | K8sSecretCreateFailedSoloError | Infrastructure | Yes |
| SOLO-5012 | StatesDirectoryNotFoundSoloError | User | No |
| SOLO-5013 | PortForwardMissingSoloError | Infrastructure | Yes |
| SOLO-5014 | NoPvcFoundSoloError | User | No |
| SOLO-5015 | ClusterReferenceUndeterminedSoloError | Solo | No |
| SOLO-5016 | UpgradeVersionFetchFailedSoloError | Infrastructure | Yes |
| SOLO-5017 | MultipleDeploymentsFoundSoloError | User | No |
| SOLO-5018 | GrpcProxyEndpointFailedSoloError | Infrastructure | Yes |
| SOLO-5019 | ExplorerPodNotFoundSoloError | Infrastructure | No |
| SOLO-5020 | ExplorerNotInRemoteConfigSoloError | User | No |
| SOLO-5021 | RelayPodNotFoundSoloError | Infrastructure | No |
| SOLO-5022 | RelayNotInRemoteConfigSoloError | User | No |
| SOLO-5023 | MirrorNodePodsNotFoundSoloError | Infrastructure | No |
| SOLO-5024 | MirrorIngressControllerPodNotFoundSoloError | Infrastructure | No |
| SOLO-5025 | MirrorNodeNotInRemoteConfigSoloError | User | No |
| SOLO-5026 | ClusterNotFoundInRemoteConfigSoloError | User | No |
| SOLO-5027 | GitHubApiRequestFailedError | Infrastructure | Yes |
| SOLO-5028 | GitHubApiHttpResponseError | Infrastructure | Yes |
| SOLO-5029 | GitHubApiResponseParseFailedError | Infrastructure | No |
| SOLO-5030 | GitHubApiResponseMissingTagNameError | Infrastructure | No |
| SOLO-5031 | BlockNodePodNotFoundSoloError | Infrastructure | Yes |
| SOLO-5032 | BlockNodeNotReadySoloError | Infrastructure | Yes |
| SOLO-5033 | BlockNodeNotInRemoteConfigSoloError | User | No |
| SOLO-5034 | ExternalBlockNodeNotInRemoteConfigSoloError | User | No |
| SOLO-5035 | HelmRepoSetupFailedSoloError | Infrastructure | No |
| SOLO-5036 | HelmRepoCheckFailedSoloError | Infrastructure | No |
| SOLO-5037 | HelmChartListFailedSoloError | Infrastructure | No |
| SOLO-5038 | HelmChartGenericInstallFailedSoloError | Infrastructure | No |
| SOLO-5039 | HelmChartUninstallFailedSoloError | Infrastructure | No |
| SOLO-5040 | HelmChartUpgradeFailedSoloError | Infrastructure | No |
| SOLO-5041 | FileNotFoundSoloError | User | No |
| SOLO-5042 | FileCopyFailedSoloError | Infrastructure | No |
| SOLO-5043 | FileEmptySoloError | User | No |
| SOLO-5044 | FileInvalidJsonSoloError | User | No |
| SOLO-5045 | DirectoryCreationFailedSoloError | Infrastructure | No |
| SOLO-5046 | ArchiveUnzipFailedSoloError | Infrastructure | No |
| SOLO-5047 | ArchiveTarFailedSoloError | Infrastructure | No |
| SOLO-5048 | ArchiveUntarFailedSoloError | Infrastructure | No |
| SOLO-5049 | DependencyVersionCheckFailedSoloError | Infrastructure | No |
| SOLO-5050 | DependencyNotFoundSoloError | Infrastructure | No |
| SOLO-5051 | DependencyManagerNotFoundSoloError | Solo | No |
| SOLO-5052 | DependencyInstallFailedSoloError | Infrastructure | No |
| SOLO-5053 | DependencyInstallDirectoryConflictSoloError | User | No |
| SOLO-5054 | GitHubReleasesNotFoundSoloError | Infrastructure | Yes |
| SOLO-5055 | GitHubReleaseTagNotFoundSoloError | Infrastructure | No |
| SOLO-5056 | GitHubReleaseAssetNotFoundSoloError | Infrastructure | No |
| SOLO-5057 | HomebrewInstallFailedSoloError | Infrastructure | No |
| SOLO-5058 | PodmanMachineInspectFailedSoloError | Infrastructure | No |
| SOLO-5059 | DockerAuthStaleSoloError | User | No |
| SOLO-5060 | PvcCreationFailedSoloError | Infrastructure | No |
| SOLO-5061 | KubernetesApiInvalidResponseSoloError | Infrastructure | No |
| SOLO-5062 | IngressClassListFailedSoloError | Infrastructure | No |
| SOLO-5063 | MultipleItemsFoundSoloError | Solo | No |
| SOLO-5064 | PodCreationFailedSoloError | Infrastructure | No |
| SOLO-5065 | PackageDownloadFailedSoloError | Infrastructure | Yes |
| SOLO-5066 | ChecksumReadFailedSoloError | Infrastructure | No |
| SOLO-5067 | ContainerInvalidPathSoloError | Solo | No |
| SOLO-5068 | ContainerOperationFailedSoloError | Infrastructure | No |
| SOLO-5069 | PostgresPodNotFoundSoloError | Infrastructure | No |
| SOLO-5070 | InitSystemFilesFailedSoloError | Infrastructure | No |
| SOLO-5071 | CacheProviderNotConfiguredSoloError | Solo | No |
| SOLO-5072 | PodTerminationTimeoutSoloError | Infrastructure | Yes |
| SOLO-5073 | ClusterRoleCheckFailedSoloError | Infrastructure | No |
| SOLO-9001 | TimeoutSoloError | Infrastructure | Yes |
Internal
| Code | Class | Ownership | Retryable |
|---|---|---|---|
| SOLO-9002 | UnsupportedOperationError | Solo | No |
| SOLO-9003 | ReadRemoteConfigBeforeLoadError | Solo | No |
| SOLO-9004 | WriteRemoteConfigBeforeLoadError | Solo | No |
| SOLO-9005 | DataValidationError | Solo | No |
| SOLO-9006 | LoggerMessageGroupNotFoundError | Solo | No |
| SOLO-9007 | CommandReturnedFalseError | Solo | No |
| SOLO-9008 | RemoteConfigUnsupportedComponentError | Solo | No |
| SOLO-9009 | RemoteConfigDeploymentNotSetError | Solo | No |
| SOLO-9010 | RemoteConfigContextUnavailableError | Solo | No |
| SOLO-9011 | CacheImageTemplateUndeclaredError | Solo | No |
| SOLO-9012 | InjectedFailureSoloError | Solo | No |