Files
proxmox/smom-dbis-138-proxmox/docs/QUICK_START.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

2.6 KiB

Quick Start Guide

Get the SMOM-DBIS-138 blockchain network running on Proxmox VE in minutes.

Prerequisites

  • Proxmox VE 7.0+ installed
  • Root access to Proxmox host
  • At least 64GB RAM and 500GB storage
  • Network connectivity

Quick Setup

1. Copy Files to Proxmox Host

# On your local machine
scp -r smom-dbis-138-proxmox root@your-proxmox-host:/opt/

2. Run Setup Script

# SSH into Proxmox host
ssh root@your-proxmox-host

# Run setup
cd /opt/smom-dbis-138-proxmox
./setup.sh

3. Configure

Edit the configuration files:

nano config/proxmox.conf
# Set: PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_SECRET, etc.

nano config/network.conf
# Review network settings (defaults usually work)

4. Deploy

# Deploy everything
./scripts/deployment/deploy-all.sh

5. Copy Project Files

After containers are created, copy configuration from your smom-dbis-138 project:

# Set source project path
SOURCE="/path/to/smom-dbis-138"

# Copy genesis and configs
for vmid in 1000 1001 1002 1003 1004 1500 1501 1502 1503 2500 2501 2502; do
    pct push $vmid "$SOURCE/config/genesis.json" /etc/besu/genesis.json
    pct push $vmid "$SOURCE/config/permissions-nodes.toml" /etc/besu/permissions-nodes.toml
done

# Copy validator keys
for vmid in 1000 1001 1002 1003 1004; do
    pct push $vmid "$SOURCE/keys/validators/" /keys/validators/
done

# Update static nodes
./scripts/network/update-static-nodes.sh

# Start services
for vmid in 1000 1001 1002 1003 1004 1500 1501 1502 1503 2500 2501 2502; do
    pct exec $vmid -- systemctl start besu-validator.service 2>/dev/null || \
    pct exec $vmid -- systemctl start besu-sentry.service 2>/dev/null || \
    pct exec $vmid -- systemctl start besu-rpc.service 2>/dev/null
done

6. Verify

# Check container status
pct list | grep -E "1000|1001|1002|1003|1004|1500|1501|1502|1503|2500|2501|2502"

# Check RPC endpoint
curl -X POST http://192.168.11.250:8545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# Check metrics
curl http://192.168.11.250:9545/metrics | head -20

Common Commands

# View logs
pct exec 1000 -- journalctl -u besu-validator -f

# Restart service
pct exec 1000 -- systemctl restart besu-validator

# Backup all
./scripts/backup/backup-all.sh

# Upgrade all nodes
./scripts/upgrade/upgrade-all.sh 24.1.0

Need Help?