Install & Use SnapsOS

SnapsOS is a lightweight command-line tool that connects directly to the SnapsVault marketplace from your terminal. It streamlines discovery, verification, download, and application of snapshots for fast node setup without manual steps.

Installation

Download and install the latest version of SnapsOS:

macOS / Linux

curl -L https://snapsvault.xyz/install/snapsos.sh | bash

This script fetches the correct binary for your system and adds it to your $PATH.

For manual installation, visit the GitHub Releases page and download the binary for your OS.

Usage Modes

SnapsOS supports two modes: Interactive and CLI.

Interactive Mode

Run without any flags to enter an interactive, step-by-step workflow with visual formatting and guided prompts.

bash snapsos.sh

What you'll see:

• Available chains listed numerically for quick selection.
• Snapshots table with columns: #, Height, Chain, Chain ID, Type, Contributor, Size (GB), Time, and SHA256 hash.
• Selection menu to choose between:
  • 1) View link — Display the direct download URL.
  • 2) View & Download — Display the URL and initiate download.

Interactive mode is ideal for manual browsing, testing, and exploration without memorizing flags.

CLI Mode

Pass flags directly to filter and fetch snapshots in a single command for automation, CI/CD, or scripting.

bash snapsos.sh --help

Available Options:

• -c, --chain NAME - Chain name (e.g., Celestia, Namada) (required)
• -i, --chain-id ID - Chain ID (e.g., celestia-1)
• -n, --network NAME - Network: mainnet or testnet
• -t, --type TYPE - Snapshot type: pruned or archive
• -l, --latest - Select the most recent snapshot by block height
• -m, --limit NUM - Maximum number of snapshots to list (default: 15)
• -q, --quiet - Print only the resolved download URL
• -h, --help - Show help and exit

Examples:

bash snapsos.sh --chain celestia --latest

Workflow Example

Here's a typical workflow using SnapsOS for node bootstrap:

1. Run interactive mode to browse

bash snapsos.sh

2. Select your chain and snapshot The tool will guide you through options.
3. Copy the URL or download directly Choose "View & Download" to fetch the snapshot.
4. Extract and apply to your node directory

tar -xzf snapshot.tar.gz -C ~/.celestia/data

For automated setups:

# Fetch URL in quiet mode and pipe to wget or curl
URL=$(bash snapsos.sh -c Celestia --latest -q)
curl -L -o snapshot.tar.gz "$URL"
tar -xzf snapshot.tar.gz -C ~/.celestia/data

Features

• Tabular snapshot display with key metadata for easy comparison.
• Formatted output using ANSI styling (bold, italic, dim) for better readability in terminals that support color.
• Case-insensitive chain and type matching for flexible input.
• Menu-driven snapshot actions after selection: view link or download directly.
• Backward navigation to return to previous menus without restarting.
• Full snapshot listing with configurable limits to avoid clutter.

Best Practices

• Always verify SHA256 hashes before applying snapshots to production nodes.
• Run SnapsOS as a non-root user in server environments.
• Use --quiet mode in scripts and automation for clean output.
• Keep the binary updated to benefit from the latest features and security fixes.
• Test in interactive mode first, then automate with CLI flags once familiar.

Troubleshooting

• Missing dependencies: Ensure curl, jq, sed, awk, grep, and tr are installed.
• No snapshots found: Verify the chain name and filters are correct. Use interactive mode to browse available options.
• Hash mismatch: Re-download the snapshot and check network stability.
• Permission errors: Ensure the target directory is writable or run with appropriate permissions.

Next Steps

• Use the Marketplace UI: Browse snapshots visually at snapsvault.xyz.
• Contribute Snapshots: Publish your own snapshots using the standardized format.
• Automate with systemd or cron: Schedule regular snapshot updates for fleet management.

---

SnapsOS bridges manual discovery and automated workflows, giving you flexibility for setup, recovery, and provisioning across supported networks.