borg-anchor

Borg backups with Bitcoin timestamping

$ npm install -g borg-anchor

Quick Start (5 min) Full Guide

Your Data
→
Borg Backup
→
Bitcoin Anchor
→
Immortal Proof

Deduplication

Only store changes, not duplicates. Second backup of same data? Just bytes.

Bitcoin Timestamping

Immutable proof your backup existed at a specific point in time.

Chained Proofs

Each backup links to previous via UTXO chain. Fully reconstructable.

Optional Encryption

AES-256 encryption with repokey. Your data stays private.

Quick Start

# Initialize backup repository
borg-anchor init ~/backups

# Configure Bitcoin key
cd ~/backups
git config nostr.privkey <your-hex-key>

# Create and anchor backup
borg-anchor backup ~/mydata --name first-backup

# Verify it's on Bitcoin
borg-anchor verify first-backup

Commands

CommandDescription
init [path]Initialize borg repo and config
backup <source>Create backup and anchor on Bitcoin
listList backups and trail status
verify <archive>Verify backup is anchored
restore <archive> [dest]Restore backup to destination
showShow config and trail status

How It Works

  1. Borg creates a deduplicated, compressed backup with a unique fingerprint (SHA-256)
  2. The fingerprint is committed to Bitcoin via a chained UTXO trail
  3. Anyone can verify the backup existed at the anchored time

The Bitcoin transaction proves your data existed before the block timestamp. No trust required - just math.

Networks

NetworkFlagUse Case
Testnet4--network tbtc4Testing (free, default)
Mainnet--network btcProduction (real Bitcoin)