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

1.7 KiB
Raw Blame History

Explorer Address Links Fix — NPMplus Port 80 Required

Issue: Address links and detail pages do not work on https://explorer.d-bis.org

Root cause: NPMplus routes explorer.d-bis.org to port 4000 (Blockscout direct) instead of port 80 (nginx).

  • Port 4000 = Blockscout's native UI — different interface, different URL structure. Our custom SPA and address links are never served.
  • Port 80 = nginx serving our custom SPA (SolaceScanScout) with working address links, path-based routing, etc. Nginx proxies /api/* to Blockscout.

Fix: Point NPMplus to Port 80

Option A: Run the update script (from LAN)

cd /home/intlc/projects/proxmox
# Ensure NPM_PASSWORD is set (check .env)
./scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh

This updates all proxy hosts including explorer.d-bis.orghttp://192.168.11.140:80.

Option B: Manual NPMplus UI

  1. Log into NPMplus: https://192.168.11.166:81 or https://192.168.11.167:81
  2. Go to Proxy Hosts → find explorer.d-bis.org
  3. Set Forward Port to 80 (not 4000)
  4. Forward Host: 192.168.11.140
  5. Save
  6. Wait 1030 seconds for NPMplus to reload

Verify

After the fix, visiting https://explorer.d-bis.org should show the custom SolaceScanScout UI. Address links and detail pages should work.

# Should return our custom SPA HTML (contains "SolaceScanScout")
curl -sI https://explorer.d-bis.org/ | head -5

Why This Happened

A previous change (see NPMPLUS_UPDATE_COMPLETE.md) switched the explorer from port 80 to port 4000 to “bypass nginx.” That routed traffic directly to Blockscout, which serves its own UI. Our custom frontend lives behind nginx on port 80.