Sparrow Sparrow / Desktop
Features FAQ Docs Download

FAQ

Common questions.
Direct answers.

Everything you need to get Sparrow running on your desktop — installation, configuration, hardware wallets, and connecting to your node.

Installation

Sparrow is available for Linux, Windows, and macOS. Choose .AppImage, .exe, or .dmg from the downloads section, or use Linux-specific packages such as .deb, .rpm, and .tar.gz.

Every release ships with a .asc signature file. Download the release, the signature file, and import the developer's signing key from the release source. Then:

gpg --keyserver keyserver.ubuntu.com --recv-keys [key-id]
gpg --verify sparrow-*.tar.gz.asc sparrow-*.tar.gz

Always verify before running. Don't skip this step.

Use .AppImage for a portable Linux build, .exe for Windows, and .dmg for macOS. On Linux, .deb and .rpm handle desktop integration for matching distributions, while .tar.gz gives you a manual install path.

Officially, no. Unofficial packages may exist but are not maintained by the Sparrow project. For a wallet application, it's important to use verified official builds. Start from our downloads section and verify the files before running them.

Node connection

Three modes: public Electrum servers (for starting out), your own Electrum server (Fulcrum, ElectrumX, Electrs, EPS, BWT) over SSL/Tor, or a direct Bitcoin Core RPC connection. For full privacy, use your own node over Tor.

Fulcrum is the recommended choice for performance — it's purpose-built for high throughput and handles large wallets efficiently. ElectrumX and Electrs are good alternatives. EPS is suitable for simple single-wallet setups.

Yes. Sparrow supports direct Bitcoin Core connection via RPC. This is the simplest setup if you're already running a node. Initial scan takes longer than with an indexed Electrum server, but it works well for most users.

Hardware wallets

Sparrow supports Coldcard, Ledger, Trezor, BitBox02, Jade, Passport, and others via USB or airgapped QR. On Linux, USB hardware wallets typically require a udev rule; most device manufacturers provide the rule in their setup documentation.

On Linux, install the Ledger udev rules. Ledger provides them in their documentation. Typically:

sudo install-ledger-udev-rules

After installing the rules, unplug and replug the device. You may also need to add your user to the plugdev group.

Yes. Sparrow supports QR code signing via the UR standard — this means you can sign PSBTs on an airgapped machine and broadcast from an online machine, with no USB connection ever made. Works with Coldcard, Passport, and any hardware wallet that supports animated QR codes.

Privacy & Tor

Yes. Sparrow bundles Tor and can route all connections through it without any external Tor installation. Enable it in Preferences → Server → Use Tor proxy. This works with both Electrum servers and the public servers list.

Nothing is sent to Sparrow's servers — there are none. All wallet data is stored locally, encrypted with Argon2 (500ms+ key derivation). When using public servers, those servers can see your wallet's addresses. For full privacy, run your own node over Tor.

Troubleshooting

Run from the terminal to see the error output: ./bin/Sparrow. Common issues include missing shared libraries (try the .deb installer which handles dependencies) or a conflicting Java version in PATH. The bundled JVM should be used automatically — check that the install isn't broken.

Wallet files are stored locally by the desktop app. Typical locations are ~/.sparrow/wallets/ on Linux, %APPDATA%\Sparrow\wallets\ on Windows, and ~/Library/Application Support/Sparrow/wallets/ on macOS. Back up the wallets directory, and keep your seed phrase written down offline.

Our documentation covers the main desktop setup path. For community support, the Telegram group is active and helpful. For bugs, use the available support channels or return to the home page.