OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Infrastructure

Solana Cluster Manager

Solana Cluster Manager is Go-based tooling for managing private clusters of Solana nodes, with commands for serving snapshot archives, collecting snapshot metadata, fetching snapshots from peer nodes and mirroring them to S3-compatible storage.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Solana Cluster Manager — OpenViST project profile in Infrastructure.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when operating a private Solana node cluster and you need documented tooling for snapshot discovery, peer-to-peer fetching or S3-compatible mirroring.

Who it is for

  • Operators managing multiple Solana nodes as a private cluster.
  • Teams that need nodes to discover and transfer snapshot archives between peers.
  • Operators who want to mirror cluster snapshots to an S3-compatible data store.

Documented uses

  • Serve available snapshot archives from a node using a sidecar.
  • Collect snapshot-version metadata from sidecars with a tracker.
  • Help a node identify and fetch a snapshot from another node.
  • Periodically mirror discovered snapshots to S3-compatible storage.
Before you choose

Requirements & limits

The repository is public and declares an Apache-2.0 license. It documents a source build requiring Go 1.18 and build essentials, and Docker images for amd64 and arm64.

  • The tracker collects metadata and helps fetch jobs find snapshots; nodes download archives directly from sidecars.
  • The sidecar and tracker APIs are explicitly not to be exposed publicly.
  • The mirror command requires S3-compatible settings and AWS access-key environment variables.
  • HTTP and JSON-file service discovery are described; Consul service discovery is marked as planned.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Build Solana Cluster Manager from source

Compile the project into a local solana-cluster binary.

Before you start

  • Go 1.18
  • Build essentials

Steps

  1. Download the Go module dependencies with go mod download.

  2. Build the binary with go build -o ./solana-cluster .

Expected outcome

A locally built solana-cluster binary.

Guide limitations

  • These steps document building only; they do not configure or run a cluster.
Documentation 1 ↗
Source-based practical guide

Run a snapshot sidecar with the documented Docker example

Start the sidecar command with a read-only ledger mount.

Before you start

  • Docker
  • A Solana ledger directory at /solana/ledger
  • A host network configuration

Steps

  1. Pull ghcr.io/blockdaemon/solana-cluster-manager.

  2. Run the image with --network-mode=host, mount /solana/ledger at /ledger:ro, and pass sidecar --ledger /ledger.

Expected outcome

The documented command starts a sidecar that serves available snapshot archives from the mounted ledger.

Guide limitations

  • The README warns not to expose the sidecar API publicly.
  • The example assumes the ledger path shown and does not document cluster-wide configuration.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
14 October 2026
Original website title
Blockdaemon/solana-cluster · Official homepage title · retained in its source language
How we review sourcesSuggest a correction