# 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
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

```bash
# 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
bash scripts/nginx-proxy-manager/migrate-configs-to-npmplus.sh \
  192.168.11.11 \
  <CONTAINER_ID> \
  https://<CONTAINER_IP>:81
```

Or run interactively:

```bash
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

```bash
# 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

```bash
# 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:**
   ```bash
   ssh root@192.168.11.11 "pct stop <NEW_CTID>"
   ```

2. **Start old NPM:**
   ```bash
   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! 🚀