Files
proxmox/docs/04-configuration/NPMPLUS_VERIFY_RUNNING_AND_NETWORK.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

3.0 KiB
Raw Permalink Blame History

NPMplus: Verify Running, IP, and Gateway

Last Updated: 2026-02-05
VMID: 10233
Host: r630-01 (192.168.11.11)


Expected configuration

Item Value Source
Gateway 192.168.11.1 config/ip-addresses.conf (NETWORK_GATEWAY); UDM Pro / LAN
Primary IP (eth0) 192.168.11.166 IP_NPMPLUS_ETH0; docs (NPMPLUS_HA_SETUP_GUIDE, NPMPLUS_SERVICE_MAPPING)
IP used by UDM Pro 192.168.11.167 Port forward 76.53.10.36:80/443 → 192.168.11.167:80/443
Admin UI Port 81 (HTTP) https://192.168.11.166:81 or https://192.168.11.167:81

NPMplus can have one or two addresses (.166 and .167); UDM Pro must forward to .167 for public access.


Verification script

From the repo (requires SSH to r630-01):

# Copy and run on Proxmox host
ssh root@192.168.11.11 'bash -s' < scripts/verify/verify-npmplus-running-and-network.sh

Or from a machine that has the repo and can SSH to r630-01, use the run-via-proxmox-ssh pattern: copy the script to the host and run it there.

On the Proxmox host directly:

# If you are already on r630-01
bash /path/to/verify-npmplus-running-and-network.sh

The script checks:

  1. Running pct status 10233 is "running"
  2. IP(s) container has at least one of 192.168.11.166, 192.168.11.167
  3. Gateway default route is 192.168.11.1
  4. Admin UI port 81 responds inside the container

If the container is stopped or IP/gateway wrong

Fix IP and gateway, then start (recommended):

# From repo (copies and runs on r630-01)
ssh root@192.168.11.11 'bash -s' < scripts/npmplus/fix-npmplus-ip-and-gateway.sh

This sets eth0 to 192.168.11.167/24, gateway 192.168.11.1, and starts the container.

Or start only:

ssh root@192.168.11.11 "pct start 10233"

Wait ~30 seconds for NPMplus (Docker) to start, then run the verification script again.


If IP or gateway is wrong

Correct the container network (run on r630-01). Example for single interface with .167 (UDM Pro):

pct set 10233 -net0 name=eth0,bridge=vmbr0,ip=192.168.11.167/24,gw=192.168.11.1
pct stop 10233
pct start 10233

Example for two interfaces (.166 and .167) if your setup uses both:

# Set eth0 to .166, add eth1 with .167 (exact syntax depends on Proxmox version and current config)
pct set 10233 -net0 name=eth0,bridge=vmbr0,ip=192.168.11.166/24,gw=192.168.11.1
# Add net1 if needed for .167
pct stop 10233
pct start 10233

After changes, re-run the verification script and confirm UDM Pro port forwarding still points to 192.168.11.167.


Quick reference

Check Command (on r630-01)
Status pct status 10233
Network config pct config 10233 | grep net
IPs inside CT pct exec 10233 -- ip -4 addr show
Gateway inside CT pct exec 10233 -- ip route show default
Admin UI (local) pct exec 10233 -- curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:81