Files
proxmox/docs/04-configuration/NPMPLUS_VERIFY_RUNNING_AND_NETWORK.md

103 lines
3.0 KiB
Markdown
Raw Normal View 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):
```bash
# 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:**
```bash
# 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):**
```bash
# 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:**
```bash
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):
```bash
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:
```bash
# 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` |