╔═══════════════════════════════════════════════════════════════════════════╗
║                    BLOODWEB ONION CHAT - QUICK REFERENCE                     ║
╚═══════════════════════════════════════════════════════════════════════════╝

🧅 ONION ADDRESS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
http://uywaowbnkm62fr7fkldpxzeg3u3csfkg4cbwcba7o5nkqxtrm67c54id.onion

⚠️  SHARE THIS ADDRESS WITH USERS VIA TOR BROWSER ONLY


🚀 SERVICE STATUS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Tor Hidden Service: Active
✅ Chat Server: Running on port 3000
✅ Database: SQLite (24h message retention)
✅ Tor Detection: Enabled


🔧 MANAGEMENT COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Check Status:
  sudo systemctl status tor@default
  ps aux | grep "node server/index.js"

Start Services:
  sudo systemctl start tor@default
  cd /var/www/html/onion && npm start

Stop Services:
  sudo systemctl stop tor@default
  pkill -f "node server/index.js"

Restart Services:
  sudo systemctl restart tor@default
  pkill -f "node server/index.js" && cd /var/www/html/onion && npm start &

View Logs:
  sudo journalctl -u tor@default -f
  tail -f /tmp/onion-chat.log

Health Check:
  curl http://127.0.0.1:3000/health


📂 IMPORTANT FILES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration:
  /etc/tor/torrc                           - Tor configuration
  /var/www/html/onion/        - Chat application

Tor Identity (BACKUP THESE!):
  /var/lib/tor/bloodweb-onion-chat/hostname
  /var/lib/tor/bloodweb-onion-chat/hs_ed25519_secret_key
  /var/lib/tor/bloodweb-onion-chat/hs_ed25519_public_key

Database:
  /var/www/html/onion/data/chat.db


🔒 ACCESS METHODS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Via Tor Browser (Anonymous):
  1. Download Tor Browser: https://www.torproject.org/download/
  2. Open Tor Browser
  3. Navigate to: http://uywaowbnkm62fr7fkldpxzeg3u3csfkg4cbwcba7o5nkqxtrm67c54id.onion

Via Regular Browser (NOT ANONYMOUS - for testing only):
  1. Navigate to: http://localhost:3000
  2. Click "I Understand the Risks" on warning page
  3. Test chat functionality


🛡️ SECURITY NOTES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✓ Zero logging - No IP addresses stored
✓ 24-hour message expiration
✓ Isolated from bloodweb infrastructure
✓ SQLite database (no MySQL dependency)
✓ Tor Browser detection enforced
✓ CSP headers prevent external resources


📊 MONITORING
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Health Endpoint:
  curl http://127.0.0.1:3000/health

Database Stats:
  sqlite3 /var/www/html/onion/data/chat.db \
    "SELECT COUNT(*) as messages FROM messages; SELECT COUNT(*) as users FROM active_users;"

Disk Usage:
  du -sh /var/www/html/onion/data/


🔄 PRODUCTION SETUP (Optional)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

For auto-start on boot, create systemd service:

1. Create /etc/systemd/system/bloodweb-onion-chat.service
   (See README.md for template)

2. Enable service:
   sudo systemctl daemon-reload
   sudo systemctl enable bloodweb-onion-chat
   sudo systemctl start bloodweb-onion-chat


💾 BACKUP STRATEGY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CRITICAL (Losing these means losing your .onion address):
  sudo tar -czf ~/tor-keys-backup-$(date +%Y%m%d).tar.gz \
    /var/lib/tor/bloodweb-onion-chat/

Optional (Messages expire anyway):
  cp /var/www/html/onion/data/chat.db \
    ~/chat-db-backup-$(date +%Y%m%d).db


📚 DOCUMENTATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Full Documentation: /var/www/html/onion/README.md
Tor Setup Guide:    /var/www/html/onion/TOR_SETUP.md


🆘 TROUBLESHOOTING
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Service won't start:
  - Check Tor: sudo systemctl status tor@default
  - Check Node: ps aux | grep node
  - Check ports: sudo netstat -tulpn | grep 3000

Can't access .onion:
  - Verify Tor Browser is running
  - Check .onion address is correct
  - Wait 30 seconds after Tor restart
  - Check Tor logs: sudo journalctl -u tor@default -xe

Database errors:
  - Check permissions: ls -la /var/www/html/onion/data/
  - Re-initialize: npm run init-db


Generated: 2026-02-14
Version: 1.0.0