# Canary Wallet

Canary Wallet is a Bitcoin monitoring and early-warning system that alerts you the moment coins in cold storage move. It is open source and self-hosted, installable on Umbrel and Docker Hub.

Canonical page: https://ourlocalhost.com/app/3511/canary-wallet

## Description

Canary Wallet is a Bitcoin monitoring and early-warning system that alerts you the moment coins in cold storage move. Built with Rust and BDK (Bitcoin Development Kit), it provides real-time transaction intelligence with advanced pattern recognition (RBF fee bumping, CPFP acceleration) and instant multilingual notifications via ntfy.sh. Set custom balance alerts (equal, less than, or more than) to monitor your holdings. Built for homelabbers monitoring cold-storage wallets and Bitcoin holdings they don't actively use.

## Platform availability

Available on 1 of 10 platforms: Umbrel.

## Health score

70/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 13 days ago)
- Popular: 25 (17 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://canarybitcoin.com
- GitHub: https://github.com/schjonhaug/canary
- Umbrel: https://apps.umbrel.com/app/canary
- Docker Hub: https://hub.docker.com/r/schjonhaug/canary-backend

## Common questions

### Does Canary Wallet need Docker installed before first start?

Yes, it starts as a Docker stack and the start commands fail without Docker installed.

### Which start script should be used on each operating system?

Run sh ./up.sh on Linux or macOS, and run .\up.ps1 on Windows; the wrong script can prevent the server from coming up.

### Can the server start without a .env file?

No, create a real .env file by copying .env.dist before starting, because the server needs that settings file to start or connect properly.

### Can Canary Wallet be used with a passphrase-enabled Trezor wallet setup?

A user discusses using a small non-passphrased wallet as a canary alert for a passphrase-enabled wallet setup.

---
Source: Our Local Host (https://ourlocalhost.com/app/3511/canary-wallet), the self-hosted and open-source app directory.
