littleshop/BTCPAY_EXTERNAL_NODES_STATUS.md
SilverLabs DevTeam 73e8773ea3 Configure BTCPay with external nodes via Tor
- Set up Tor container for SOCKS proxy (port 9050)
- Configured Monero wallet with remote onion node
- Bitcoin node continues syncing in background (60% complete)
- Created documentation for wallet configuration steps
- All external connections routed through Tor for privacy

BTCPay requires manual wallet configuration through web interface:
- Bitcoin: Need to add xpub/zpub for watch-only wallet
- Monero: Need to add address and view key

System ready for payment acceptance once wallets configured.
2025-09-19 12:14:39 +01:00

4.1 KiB

BTCPay External Nodes Configuration Status

Configuration Completed

Infrastructure Setup

  1. Tor Container: Running and connected (port 9050)
  2. Bitcoin Node: Running but only 60% synced (continuing in background)
  3. Monero Remote Wallet: Running with Tor onion node connection
  4. BTCPay Server: Running and accessible

Current Configuration

Tor Network

  • Status: Fully operational
  • SOCKS Port: 9050
  • Container: tor (running)
  • Bootstrap: 100% complete

Bitcoin Setup

  • Local Node: Running (60% synced, July 2022)
  • Container: btcpayserver_bitcoind
  • Pruned Mode: 10GB max storage
  • Will sync in background: ~2-3 weeks to complete

Monero Setup

  • Remote Node Used: zbjkbsxc5munw3qusl7j2hpcmikhqocdf4pqhnhtpzw5nt5jrmofptid.onion:18089
  • Connection: Via Tor SOCKS proxy
  • Container: monero_wallet_remote
  • RPC Port: 18082
  • Credentials: btcpay:btcpay

⚠️ Manual Steps Required in BTCPay Admin

To complete the setup and start accepting payments, you need to configure wallets through the BTCPay web interface:

For Bitcoin (Immediate Setup - No Sync Required)

  1. Login to BTCPay: https://thebankofdebbie.giize.com
  2. Navigate to: Store Settings → Wallets → Bitcoin
  3. Choose Setup Method:
    • Click "Connect an existing wallet"
    • Select "Enter extended public key"
  4. Enter Your xpub/zpub:
    • For testing: xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB
    • For production: Generate from your hardware wallet or Bitcoin Core
  5. Configure Derivation:
    • Account Key Path: m/84'/0'/0' (for native segwit)
    • Or use Legacy: m/44'/0'/0'
  6. Save Configuration

For Monero (Requires View Key)

  1. Navigate to: Store Settings → Wallets → Monero
  2. Configure Wallet:
    • Primary Address: Your Monero address
    • View Key: Your private view key (for incoming payment detection)
  3. Save Configuration

Alternative: Use External Services (Fastest)

If you need immediate operation without any node syncing:

Option 1: BTCPay Server Demo (Immediate)

  1. Use BTCPay's demo server: https://testnet.demo.btcpayserver.org
  2. Create account and store
  3. Update LittleShop configuration with new credentials

Option 2: Third-Party BTCPay Host

Option 3: Electrum Personal Server

  1. Install Electrum Personal Server locally
  2. Connect it to public Electrum servers via Tor
  3. Configure BTCPay to use your EPS instance

Current Payment Status

  • Bitcoin: Requires wallet configuration (xpub/zpub)
  • Monero: Requires wallet configuration (address + view key)
  • API Connection: Working
  • Invoice Creation: Will work after wallet setup

Monitoring Commands

# Check Bitcoin sync progress
ssh -i /silverlabs/src/LittleShop/Hostinger/vps_hardening_key -p 2255 sysadmin@thebankofdebbie.giize.com \
  "docker logs btcpayserver_bitcoind --tail 5 | grep progress"

# Check Tor status
ssh -i /silverlabs/src/LittleShop/Hostinger/vps_hardening_key -p 2255 sysadmin@thebankofdebbie.giize.com \
  "docker logs tor --tail 5"

# Check Monero wallet
ssh -i /silverlabs/src/LittleShop/Hostinger/vps_hardening_key -p 2255 sysadmin@thebankofdebbie.giize.com \
  "docker logs monero_wallet_remote --tail 5"

# Test BTCPay connection
curl https://thebankofdebbie.giize.com/api/v1/stores \
  -H "Authorization: token db920209c0101efdbd1c6b6d1c99a48e3ba9d0de"

Summary

The infrastructure is ready with external node connectivity via Tor. However, BTCPay requires wallet configuration through its web interface to start accepting payments. You can either:

  1. Configure watch-only wallets (xpub for Bitcoin, view key for Monero) - Immediate
  2. Wait for local Bitcoin sync to complete (~2-3 weeks) - Most private
  3. Use external BTCPay service temporarily - Fastest

The system is designed for privacy with all external connections routed through Tor.