@authoritydmc/localssl

⚡️ Zero-config multi-device local HTTPS reverse proxy and certificate engine with automatic sslip.io DNS, Java PKCS12 / Python PEM outputs, and terminal QR code mobile pairing.

💡 Why LocalSSL?

Testing local HTTPS across multiple devices (phones, tablets, other machines on your WiFi) usually requires configuring local DNS, editing /etc/hosts, or fighting self-signed certificate errors.

LocalSSL solves this completely:

• 🌐 No DNS Setup: Uses sslip.io wildcard DNS (e.g. 192.168.1.50.sslip.io) which resolves on any mobile device on your WiFi out of the box.
• ⚡️ Zero Code Changes: Instant HTTPS reverse proxy forwarding to your existing HTTP dev server (localhost:3000 $\rightarrow$ https://<LAN_IP>.sslip.io:3400).
• 📱 Terminal QR Code Pairing: Scan the terminal QR code with your phone camera to install the Root CA or open your HTTPS dev server immediately.
• ☕ Multi-Language Ready: Auto-generates server.pem (Python/Node/Go) and keystore.p12 (Java / Spring Boot).

📦 Installation

npm install -g @authoritydmc/localssl
# or run directly with npx
npx @authoritydmc/localssl proxy 3000

🚀 Quick Usage

1. Instant HTTPS Reverse Proxy (Zero Code Changes)

If your dev server is running on http://localhost:3000:

localssl proxy 3000

This starts an HTTPS reverse proxy with WebSockets (HMR) and displays a QR code to open your secure app on your phone.

2. 1-Click Mobile Root CA Installer

localssl serve

Renders a terminal QR code. Scan with your phone to download rootCA.pem and install it as a trusted certificate authority in 2 taps.

3. Generate Standalone Certificates

# Generate for current machine's LAN IP
localssl cert

# Or for a specific IP and directory
localssl cert 192.168.1.50 ./certs

Generated Files:

• server.pem (Server certificate)
• server-key.pem (Private key)
• fullchain.pem (Server certificate + Root CA)
• keystore.p12 (Java / Spring Boot PKCS12 keystore, password: changeit)

📄 License

MIT © Raj Dubey