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

43 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
```bash
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.org``http://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.
```bash
# 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.