proxmox/docs/04-configuration/MIGRATION_STATUS.md

NPMplus Migration Status

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

---

Date: 2026-01-16
Status: Scripts Ready - Manual Installation Required

---

✅ Completed

1. Backup Scripts Created

   • ✅ Current NPM backup functionality
   • ✅ Database export capability
   • ✅ Configuration export scripts

2. Migration Scripts Created

   • ✅ migrate-to-npmplus.sh - Full automated migration
   • ✅ migrate-configs-to-npmplus.sh - Configuration migration only
   • ✅ complete-migration.sh - Complete orchestration script
   • ✅ post-install-migration.sh - Post-installation automation

3. Documentation Created

   • ✅ NPMPLUS_MIGRATION_GUIDE.md - Complete migration guide
   • ✅ NPMPLUS_QUICK_START.md - Quick start guide
   • ✅ All 19 domains documented with correct IPs

4. Backup Completed

   • ✅ Current NPM database backed up
   • ✅ Backup location: /tmp/npm-migration-YYYYMMDD_HHMMSS/

---

⚠️ Manual Steps Required

Step 1: Install NPMplus

Due to network/DNS issues preventing automated installation, please install NPMplus manually:

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

When prompted:

• Timezone: America/New_York
• ACME Email: nsatoshi2007@hotmail.com

After installation:

• Note the container ID (VMID)
• Note the container IP address
• Get admin password: pct exec <CTID> -- cat /opt/.npm_pwd

---

Step 2: Run Post-Installation Migration

After NPMplus is installed, run:

bash scripts/nginx-proxy-manager/post-install-migration.sh \
  192.168.11.11 \
  <CONTAINER_ID> \
  <CONTAINER_IP>

Or use the complete migration script:

bash scripts/nginx-proxy-manager/complete-migration.sh

---

Step 3: Update UDM Pro Port Forwarding

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

---

Step 4: Verify Migration

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

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

---

📋 What Gets Migrated

All 19 domains will be automatically configured:

sankofa.nexus (5 domains)

• sankofa.nexus
• www.sankofa.nexus
• phoenix.sankofa.nexus
• www.phoenix.sankofa.nexus
• the-order.sankofa.nexus

d-bis.org (9 domains)

• explorer.d-bis.org
• rpc-http-pub.d-bis.org
• rpc-ws-pub.d-bis.org
• rpc-http-prv.d-bis.org
• rpc-ws-prv.d-bis.org
• dbis-admin.d-bis.org
• dbis-api.d-bis.org
• dbis-api-2.d-bis.org
• secure.d-bis.org

mim4u.org (4 domains)

• mim4u.org
• www.mim4u.org
• secure.mim4u.org
• training.mim4u.org

defi-oracle.io (1 domain)

• rpc.public-0138.defi-oracle.io

---

🔧 Troubleshooting

Installation Fails

• Check DNS resolution on Proxmox host
• Verify internet connectivity
• Check Proxmox storage availability

Migration Script Fails

• Verify NPMplus is running: pct exec <CTID> -- docker ps
• Check admin password: pct exec <CTID> -- cat /opt/.npm_pwd
• Verify container IP is correct
• Check API access: curl -k https://<ip>:81/api

SSL Certificates Not Issuing

• Verify DNS records point to 76.53.10.36
• Wait 1-2 minutes for Let's Encrypt processing
• Check NPMplus logs: docker logs npmplus

---

📁 Scripts Available

1. complete-migration.sh - Full orchestration (recommended)
2. post-install-migration.sh - After NPMplus is installed
3. migrate-configs-to-npmplus.sh - Configuration migration only
4. migrate-to-npmplus.sh - Full automated (requires NPMplus installed)

---

🎯 Next Actions

1. ✅ Install NPMplus manually (see Step 1 above)
2. ✅ Run post-installation migration script
3. ✅ Update UDM Pro port forwarding
4. ✅ Verify all domains and SSL certificates
5. ✅ Monitor for 24-48 hours
6. ✅ (Optional) Stop old NPM container after verification

---

All scripts and documentation are ready. Proceed with manual NPMplus installation, then run the migration scripts.