explorer-monorepo/NPMPLUS_CREDENTIALS_GUIDE.md

NPMplus Credentials Guide

Date: 2026-01-21
Purpose: Configure Let's Encrypt certificate for explorer.d-bis.org

---

NPMplus Dashboard Access

URL

• Dashboard: https://192.168.11.167:81
• From internal network only

Credentials

The email and password for NPMplus are stored in the .env file in the explorer-monorepo directory.

To find credentials:

1. Check the .env file in the project root
2. Look for NPM_EMAIL and NPM_PASSWORD variables
3. Or check the NPMplus container directly

---

Manual Certificate Configuration

If automated script doesn't work, configure manually:

Step 1: Access NPMplus Dashboard

1. Open browser: https://192.168.11.167:81
2. Login with credentials from .env file

Step 2: Request Let's Encrypt Certificate

1. Click "SSL Certificates" in left menu
2. Click "Add SSL Certificate"
3. Select "Let's Encrypt"
4. Fill in:
   • Domain Names: explorer.d-bis.org
   • Email: (from .env file - NPM_EMAIL)
   • Agree to Terms: Yes
5. Click "Save"

Step 3: Assign Certificate to Proxy Host

1. Click "Proxy Hosts" in left menu
2. Find and click "explorer.d-bis.org"
3. Scroll to "SSL Certificate" section
4. Select the Let's Encrypt certificate you just created
5. Enable:
   • ✅ Force SSL
   • ✅ HTTP/2 Support
   • ✅ HSTS Enabled (optional)
6. Click "Save"

Step 4: Wait for Certificate

• Let's Encrypt certificate issuance takes 1-2 minutes
• Check certificate status in "SSL Certificates" section
• Once issued, the certificate will be automatically assigned

---

Verification

After configuration:

# Test without SSL verification bypass
curl -I https://explorer.d-bis.org

# Should return HTTP 200, 301, or 302
# Should NOT show SSL certificate error

---

Troubleshooting

If Authentication Fails

1. Check credentials in .env file:

   cd /home/intlc/projects/proxmox/explorer-monorepo
   grep NPM_EMAIL .env
   grep NPM_PASSWORD .env
   

2. Check NPMplus container:

   ssh root@r630-01
   pct exec 10233 -- docker exec npmplus cat /data/npm/.npm_pwd
   

3. Reset password (if needed):

   • Access NPMplus container
   • Use NPMplus password reset feature
   • Or check container logs for initial setup credentials

If Certificate Request Fails

1. Check DNS: Ensure explorer.d-bis.org resolves to 76.53.10.36
2. Check Port Forwarding: Ensure ports 80/443 are forwarded correctly
3. Check Firewall: Ensure UDM Pro allows Let's Encrypt validation
4. Check NPMplus Logs: Look for certificate request errors

---

Summary

Status: ⚠️ MANUAL CONFIGURATION REQUIRED

Action:

1. Access NPMplus dashboard at https://192.168.11.167:81
2. Use credentials from .env file
3. Request Let's Encrypt certificate manually
4. Assign to explorer.d-bis.org proxy host

---

Next Step: Access NPMplus dashboard and configure certificate manually