proxmox/docs/04-configuration/NPMPLUS_QUICK_START.md

NPMplus Quick Start Guide

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation

---

Quick migration from Nginx Proxy Manager to NPMplus

---

Step 1: Install NPMplus

On your Proxmox host, run:

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/npmplus.sh)"

During installation:

• Enter timezone: America/New_York (or your timezone)
• Enter ACME email: nsatoshi2007@hotmail.com
• Note the container ID (VMID) that gets created
• Wait 1-2 minutes for NPMplus to start

After installation:

• Access URL: https://<container-IP>:81
• Default email: admin@example.org
• Get password: pct exec <CTID> -- cat /opt/.npm_pwd

---

Step 2: Get Container Information

# Get container ID and IP
ssh root@192.168.11.11 "pct list | grep npmplus"

# Get container IP
ssh root@192.168.11.11 "pct exec <CTID> -- hostname -I | awk '{print \$1}'"

# Get admin password
ssh root@192.168.11.11 "pct exec <CTID> -- cat /opt/.npm_pwd"

---

Step 3: Migrate Configurations

Run the migration script:

bash scripts/nginx-proxy-manager/migrate-configs-to-npmplus.sh \
  192.168.11.11 \
  <CONTAINER_ID> \
  https://<CONTAINER_IP>:81

Or run interactively:

bash scripts/nginx-proxy-manager/migrate-configs-to-npmplus.sh

This will:

• ✅ Configure all 19 domains
• ✅ Request SSL certificates for all domains
• ✅ Enable HTTPS, HTTP/2, HSTS, and security features

---

Step 4: Update Network Configuration

Update UDM Pro Port Forwarding

1. Log into UDM Pro
2. Settings → Networks → Port Forwarding
3. Update both rules:
   • HTTP (80): 76.53.10.36:80 → <new-npmplus-ip>:80
   • HTTPS (443): 76.53.10.36:443 → <new-npmplus-ip>:443

---

Step 5: Verify Migration

# Test SSL certificates
bash scripts/check-east-west-ssl-status.sh

# Test admin UI
curl -k https://<npmplus-ip>:81

# Check all domains are accessible
for domain in sankofa.nexus explorer.d-bis.org mim4u.org; do
  echo "Testing $domain..."
  curl -I https://$domain 2>&1 | head -1
done

---

Troubleshooting

Cannot Access Admin UI

# Check container status
ssh root@192.168.11.11 "pct status <CTID>"

# Check Docker logs
ssh root@192.168.11.11 "pct exec <CTID> -- docker logs npmplus"

# Check if port 81 is listening
ssh root@192.168.11.11 "pct exec <CTID> -- netstat -tlnp | grep 81"

SSL Certificates Not Issuing

1. Verify DNS records point to 76.53.10.36
2. Wait 1-2 minutes for Let's Encrypt to process
3. Check NPMplus logs: docker logs npmplus | grep -i cert

Migration Script Fails

1. Check authentication: Try logging into web UI manually
2. Verify container ID and IP are correct
3. Check if jq is installed: pct exec <CTID> -- which jq
4. Install jq if needed: pct exec <CTID> -- apk add jq

---

Rollback

If something goes wrong:

1. Stop new container:

   ssh root@192.168.11.11 "pct stop <NEW_CTID>"
   

2. Start old NPM:

   ssh root@192.168.11.11 "pct start 105"
   

3. Update port forwarding back to old IP:

   • UDM Pro → Port Forwarding → Update to 192.168.11.26

---

What's Different in NPMplus?

• ✅ HTTP/3 (QUIC) - Faster connections
• ✅ CrowdSec IPS - Intrusion prevention
• ✅ GoAccess - Real-time log analysis
• ✅ ModSecurity - Web application firewall
• ✅ OCSP Stapling - Better SSL performance
• ✅ TLS 1.2/1.3 Only - Enhanced security
• ✅ Faster Certificates - Quicker SSL issuance

---

Full Documentation

See docs/04-configuration/NPMPLUS_MIGRATION_GUIDE.md for complete details.

---

Ready to migrate? Start with Step 1 above! 🚀