Getting started

This page gets the pear CLI onto your machine and points you at how to stage, seed, and release an app you already have. Don't have an app yet? Build one on P2P—a type-along tutorial that builds a peer-to-peer chat app from scratch, then reshapes it into the production hello-pear-electron scaffold this page's release steps assume.

Install Pear

Get the pear CLI from install.pears.com:

curl https://install.pears.com/pear.sh | sh

irm https://install.pears.com/pear.ps1 | iex

npx pear

docker run -it --rm tetherto/pear

Follow the PATH instructions the installer prints, then run pear directly. See Install & upgrade for the npm-global alternative and upgrade details. The tetherto/pear image runs Pear inside Ubuntu with pear and pear-install ready to go—handy for trying the CLI without installing anything locally.

Already have a built app? Ship it

The deep, step-by-step guides for every part of the release pipeline already exist as how-tos—this section signposts into them rather than repeating them:

• Deploy your application—pear touch, pear stage, pear provision, and pear seed, the core stage → provision → seed flow.
• Build & package—desktop distributables, binaries, and app-store submissions.
• CI/CD with GitHub Actions—automate the same flow from CI.
• Multisig—require multiple signers before a production release goes live.

For the concepts behind that flow—what staging, provisioning, and multisig actually do and why—see Release pipeline.

Where to go next

• Build a peer-to-peer chat—the full type-along tutorial, if you're starting from nothing.
• Command Line Interface (CLI)—every pear command and flag.
• Manage installed applications—list installed Pear apps and reset their storage.
• Troubleshoot common issues—fixes for common Pear CLI and deployment issues.