d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
6945f69d7d28deb09eaaebb009035f6cf6c2ad52
proxmox/docs/12-quick-reference/QUICK_REFERENCE_CARDS.md
defiQUG dbd517b279 Sync workspace: config, docs, scripts, CI, operator rules, and submodule pointers. 
- Update dbis_core, cross-chain-pmm-lps, explorer-monorepo, metamask-integration, pr-workspace/chains
- Omit embedded publish git dirs and empty placeholders from index

Made-with: Cursor
2026-04-12 06:12:20 -07:00

165 lines
7.3 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.
# Quick Reference Cards
**Last Updated:** 2026-02-12
**Document Version:** 1.1
**Status:** Active Documentation
---
## 1. Network Quick Reference
| Item | Value |
|------|-------|
| Management VLAN | 11 (192.168.11.0/24) |
| Gateway | 192.168.11.1 |
| Proxmox hosts | ml110 192.168.11.10, r630-01 .11, r630-02 .12 |
| NPMplus (VMID 10233) | 192.168.11.166, 192.168.11.167 (only .167 in UDM Pro) |
| UDM Pro (edge) | 76.53.10.34 |
| Public ingress | 76.53.10.36:80/443 → 192.168.11.167:80/443 |
| Besu Validator VLAN | 110 (10.110.0.0/24) |
| Besu Sentry VLAN | 111 (10.111.0.0/24) |
| Besu RPC VLAN | 112 (10.112.0.0/24) |
| CCIP Commit VLAN | 132 (10.132.0.0/24) |
| CCIP Execute VLAN | 133 (10.133.0.0/24) |
| CCIP RMN VLAN | 134 (10.134.0.0/24) |
**See:** [NETWORK_ARCHITECTURE.md](../02-architecture/NETWORK_ARCHITECTURE.md), [NETWORK_CONFIGURATION_MASTER.md](../11-references/NETWORK_CONFIGURATION_MASTER.md).
---
## 2. VMID Ranges Quick Reference
| Range | Purpose |
|-------|---------|
| 100–130 | Infrastructure, monitoring |
| 1000–1499 | Besu validators |
| 1500–1999 | Besu sentries |
| 2101–2103, 2201, 2301, 2303–2308 | Core/public/private RPC nodes |
| 2400–2403, 2420, 2430, 2440, 2460, 2470, 2480 | Thirdweb + edge permissioned/private RPC nodes |
| 5000 | Explorer (Blockscout) |
| 7810–7811 | MIM4U |
| 10233 | NPMplus LXC |
**See:** [VMID_ALLOCATION_FINAL.md](../02-architecture/VMID_ALLOCATION_FINAL.md).
---
## 2.1 CCIP Relay Service (Chain 138 → Mainnet)
| Item | Value |
|------|-------|
| **Host** | r630-01 (192.168.11.11) |
| **Path** | `/opt/smom-dbis-138/services/relay` |
| **Chain 138 Public RPC** | `RPC_URL_138_PUBLIC` — VMID 2201 (192.168.11.221:8545) |
| **Logs** | `ssh root@192.168.11.11 "tail -f /opt/smom-dbis-138/services/relay/relay-service.log"` |
**See:** [07-ccip/CCIP_RELAY_DEPLOYMENT.md](../07-ccip/CCIP_RELAY_DEPLOYMENT.md).
---
## 2.2 Chain 138 contract check & deploy
| Item | Value |
|------|-------|
| **On-chain check** | `./scripts/verify/check-contracts-on-chain-138.sh` (uses `RPC_URL_138`, current canonical target `75/75`) |
| **Deploy (Forge)** | Always use `--with-gas-price 1000000000` on Chain 138 |
| **Addresses** | [CONTRACT_ADDRESSES_REFERENCE](../11-references/CONTRACT_ADDRESSES_REFERENCE.md), [ADDRESS_MATRIX_AND_STATUS](../11-references/ADDRESS_MATRIX_AND_STATUS.md) |
---
## 2.3 Token mapping (138↔Mainnet)
| Item | Value |
|------|-------|
| **Source of truth** | [config/token-mapping.json](../../config/token-mapping.json) |
| **Relay-supported** | WETH9 only (Mainnet CCIPRelayBridge); LINK mapped for future use |
| **When adding tokens** | Update token-mapping.json; optionally [CHAIN138_TOKEN_ADDRESSES](../11-references/CHAIN138_TOKEN_ADDRESSES.md) |
**See:** [07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md](../07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md), [07-ccip/CCIP_BRIDGE_MAINNET_CONNECTION.md](../07-ccip/CCIP_BRIDGE_MAINNET_CONNECTION.md).
---
## 3. Common Proxmox Commands
| Task | Command |
|------|---------|
| List VMs/containers | `pct list` or `qm list` |
| Status | `pct status <vmid>` or `qm status <vmid>` |
| Start/stop | `pct start <vmid>`, `pct stop <vmid>` |
| Console | `pct console <vmid>` |
| Config | `pct config <vmid>` |
| Cluster status | `pvecm status` |
| Storage | `pvesm status` |
| Logs (container) | `journalctl -u pve-container@<vmid>` |
**Example with expected output:**
```bash
pvecm status
```
Expected: Cluster name, quorum status, node list (e.g. `r630-01`, `r630-02`).
```bash
pct list
```
Expected: Table with columns VMID, status, name, type (e.g. `running`, `ubuntu-22`).
**See:** [OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md), [QUICK_REFERENCE.md](QUICK_REFERENCE.md).
---
## 3.1 Documentation Index (ALL_IMPROVEMENTS 68–74)
| # | Item | Link |
|---|------|------|
| 68 | Quick reference cards | This document; [QUICK_REFERENCE.md](QUICK_REFERENCE.md), [TROUBLESHOOTING_QUICK_REFERENCE.md](TROUBLESHOOTING_QUICK_REFERENCE.md) |
| 69 | Decision trees | [CONFIGURATION_DECISION_TREE.md](../10-best-practices/CONFIGURATION_DECISION_TREE.md) |
| 70 | Configuration templates | [ER605](../04-configuration/ER605_ROUTER_CONFIGURATION.md), [RPC_ENDPOINTS_MASTER](../04-configuration/RPC_ENDPOINTS_MASTER.md), [.env.example](../04-configuration/) in services |
| 71 | Examples and use cases | [OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md), [TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md) |
| 72 | Glossary and terminology | [GLOSSARY.md](../11-references/GLOSSARY.md) |
| 73 | Visual elements | [NETWORK_ARCHITECTURE.md](../02-architecture/NETWORK_ARCHITECTURE.md), [MASTER_INDEX.md](../MASTER_INDEX.md) |
| 74 | Organization (TOC, cross-links) | [MASTER_INDEX.md](../MASTER_INDEX.md), [docs/README.md](../README.md) |
---
## 4. Troubleshooting Quick Reference
| Symptom | First checks |
|---------|----------------|
| Container won't start | `pct status <vmid>`, `pct config <vmid>`, `journalctl -u pve-container@<vmid>` |
| Service down | `systemctl status <service>`, logs |
| Network / no connectivity | `ping`, `curl`, DNS, firewall |
| Consensus / QBFT | [QBFT_TROUBLESHOOTING.md](../09-troubleshooting/QBFT_TROUBLESHOOTING.md) |
| RPC not responding | Check current RPC fleet (`2101`-`2103`, `2201`, `2301`/`2303`-`2308`, `2400`-`2403`, `2420`/`2430`/`2440`, `2460`/`2470`/`2480`), NGINX, Cloudflare tunnel |
| Cloudflare tunnel | [CLOUDFLARE_ROUTING_MASTER.md](../05-network/CLOUDFLARE_ROUTING_MASTER.md) |
**See:** [TROUBLESHOOTING_FAQ.md](../09-troubleshooting/TROUBLESHOOTING_FAQ.md).
---
## 5. Verification & E2E
| Task | Command / Location |
|------|--------------------|
| Full verification (deps + E2E) | `bash scripts/verify/run-full-verification.sh` |
| E2E routing only | `bash scripts/verify/verify-end-to-end-routing.sh --profile=public` |
| E2E with Option B (RPC via tunnel) | `ACCEPT_ANY_DNS=1 bash scripts/verify/verify-end-to-end-routing.sh --profile=public` |
| Dependencies check | `bash scripts/verify/check-dependencies.sh` |
| NPMplus RPC fix (from LAN) | `bash scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh` |
| NPMplus backup | `bash scripts/verify/backup-npmplus.sh` |
| Config & decision trees | [CONFIGURATION_DECISION_TREE.md](../10-best-practices/CONFIGURATION_DECISION_TREE.md) (canonical); [04-configuration version](../04-configuration/CONFIGURATION_DECISION_TREE.md) (mermaid diagram) |
| Config templates / examples | [04-configuration/README.md](../04-configuration/README.md), [INGRESS_SOURCE_OF_TRUTH.json](../04-configuration/INGRESS_SOURCE_OF_TRUTH.json) |
**CoinGecko / Snap / Explorer (W1-22–W1-24):** CoinGecko listing: [smom-dbis-138/services/token-aggregation/docs/COINGECKO_SUBMISSION.md](../../smom-dbis-138/services/token-aggregation/docs/COINGECKO_SUBMISSION.md). Chain 138 Snap (market data, swap, bridge): `metamask-integration/chain138-snap/`. Explorer (dark mode, network selector, sync): `explorer-monorepo/`.
**See:** [E2E_CLOUDFLARE_DOMAINS_RUNBOOK.md](../05-network/E2E_CLOUDFLARE_DOMAINS_RUNBOOK.md), [FULL_PARALLEL_EXECUTION_ORDER.md](../00-meta/FULL_PARALLEL_EXECUTION_ORDER.md).
---
## Related Documentation
- [MASTER_INDEX.md](../MASTER_INDEX.md) - Complete documentation index
- [VALIDATED_SET_QUICK_REFERENCE.md](VALIDATED_SET_QUICK_REFERENCE.md) - Validated set reference
- [QUICK_REFERENCE.md](QUICK_REFERENCE.md) - ProxmoxVE scripts quick reference
Reference in New Issue View Git Blame Copy Permalink