# Sat.watch

Sat.watch is a self-hosted Bitcoin monitoring application that watches addresses, extended public keys (xpubs), or descriptors and sends email or webhook alerts when transactions are detected, so homelab users can. It is open source and self-hosted, installable on Umbrel.

Canonical page: https://ourlocalhost.com/app/3510/sat-watch

## Description

Sat.watch is a self-hosted Bitcoin monitoring application that watches addresses, extended public keys (xpubs), or descriptors and sends email or webhook alerts when transactions are detected, so homelab users can track their funds in real time.

## Platform availability

Available on 1 of 10 platforms: Umbrel.

## Health score

33/100 (Low), based on 4 of 5 factors.
- Maintained: 52 (last commit 208 days ago)
- Popular: 29 (26 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 0 (5 serious findings, 5 minor, CI, tests)

## Security check

5 serious findings: Uses github.com/jackc/pgx/v5 v5.7.4, which has a known critical vulnerability; Uses github.com/jackc/pgx/v5 v5.7.4, which has a known critical vulnerability; Uses github.com/labstack/echo/v4 v4.13.3, which has a known critical vulnerability; Uses golang.org/x/crypto v0.37.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.37.0, which has a known critical vulnerability.
Automated checks on commit fd5537c, 16 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/jpcummins/sat.watch
- Umbrel: https://apps.umbrel.com/app/satwatch

## Common questions

### Does the recommended Docker setup include the required blockchain and Electrum components?

Yes, the recommended Docker setup includes Bitcoin Core and an Electrum server. It still needs Postgres and SMTP configured with environment variables.

### Which port should I configure for the Electrum server?

Use the ELECTRUM_PORT setting for the Electrum server SSL port. The README says this is typically 50002.

### How do I make email notification links point to the correct self-hosted address?

Set the URL environment variable to the base URL used in email notifications. For development, use the local host and port 8080.

### How do I create the first account for accessing the app?

Run the create-user command with -username and -password, then start the satwatch server. The server is then reachable at the local 8080 port.

### What SMTP settings are required for email alerts?

Set SMTP_HOST, SMTP_PORT, SMTP_USER, and SMTP_PASSWORD for email delivery.

### What value do I set to protect session cookies?

Set the SECRET environment variable. It is used to encrypt session cookies.

---
Source: Our Local Host (https://ourlocalhost.com/app/3510/sat-watch), the self-hosted and open-source app directory.
