Documentation
New to Solo? Start with the Quickstart → to deploy your first local network in one command.
Known issue: MinIO image pulls are currently blocked. MinIO stopped
publishing new community images as of 2025-10-23, so deployments with MinIO
enabled fail with ImagePullBackOff. This affects Solo versions below
v0.91.0; starting with v0.91.0, Solo replaces the default tenant image and
no workaround is needed.
- Easiest fix: run
ONE_SHOT_WITH_BLOCK_NODE=true BLOCK_STREAM_STREAM_MODE=BLOCKS solo one-shot single deployto skip MinIO entirely. - If you need MinIO (record streams/backups): see the values-file workaround in Troubleshooting.
Browse the docs
Get started with Solo quickly. This section guides you through prerequisites, one-command deployment, network management, and cleanup. Perfect for developers and testers getting their first Hiero network running locally.
Deep-dive into advanced deployment methods, network customization, and operational management. This section covers YAML-driven deployments, manual component orchestration, dynamic node management, and CI/CD integration. Ideal for DevOps engineers and system administrators requiring full control.
Explore practical applications and integrations for Solo. This section covers using Solo networks with the JavaScript SDK, integrating with external tools, building applications on Hiero consensus nodes, and deploying locally built consensus node binaries for development and testing.
Solutions to common issues when using Solo, plus guidance on getting help. This document covers installation problems, pod readiness issues, resource constraints, and how to find additional support.