How do I… use the digstore CLI?
Drive everything from your terminal.
digstoreis the Git-shaped CLI for creating, publishing, sharing, and reading stores — scriptable and CI-ready. This page maps each task to the page that walks it. Building and previewing are free; you spend only when you publish.
The mental model
The loop mirrors Git: scaffold and preview locally for free, then init to mint a store and commit to publish each capsule (a new on-chain root). A capsule costs the uniform price in $DIG; everything before publishing costs nothing. Configuration lives in a committable dig.toml (no secrets — those come from the environment).
How do I install it?
Grab the installer for your OS from the Releases page (or build from source), then confirm with digstore --version.
How do I try it before I spend anything?
Scaffold a runnable project with digstore new <template> and preview it live with digstore dev — served over the genuine chia:// read path with live reload and an injected dev window.chia. No mint, no chain, no spend. digstore doctor runs a pre-publish preflight, and digstore commit --dry-run previews the exact $DIG/XCH cost without spending.
→ Scaffold an app · CLI tutorial
How do I set up a wallet?
Publishing spends real funds, so generate or import a seed and fund the wallet first: digstore seed generate, then digstore balance to see your receive address.
→ On-chain anchoring · Where to get DIG
How do I publish my first capsule?
digstore init site --dir dist mints the store's singleton on Chia mainnet — the launcher id becomes your store id — and blocks until confirmed.
How do I ship an update?
digstore add -A then digstore commit -m "v1.1" seals the current content into a new capsule and advances your on-chain root. For CI, digstore deploy --output-dir dist --json does add → commit → push in one command and never mints.
→ Using DigStore in your project · Project config
How do I share it / serve it over a remote?
push, clone, and pull move a store over a §21 remote (the default is the public DIGHUb). This is the basis for hosting your own content and for the deploy flow.
How do I read content back?
digstore cat urn:dig:chia:<storeId>/<resource> — a URN both locates and decrypts the resource. The same chunked, verify-then-decrypt path the network uses.
How do I deploy from GitHub Actions?
Wire dig-network/deploy-action so every push publishes a new capsule, with an if-changed guard (a byte-identical build is a no-op, no spend) and free PR previews. Authorize CI with a revocable deploy key — never your wallet seed.
→ Deploy from GitHub Actions · Deploy keys
Where's every command?
The full reference, with the on-chain-cost notes and the free pre-publish commands.
Go deeper
- The full builder overview → For app developers
- The store format → What is DigStore? · Store structure
- Everything → Protocol deep-dive · Concepts & glossary