Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔒 Local SSL Manager

Zero-friction HTTPS for local development
Create, trust, and manage self-signed certificates without the hassle

Go Cross Platform License

✨ Why This Tool?

Stop wrestling with browser security warnings and complex certificate setups. Get HTTPS working locally in seconds, not hours.

# One command to rule them all
./ssl-manager create api.local && ./ssl-manager trust api.local
# ✅ https://api.local now works in your browser

🚀 Quick Start

Install

go build -o ssl-manager

Create & Trust a Certificate

./ssl-manager create myapp.local
./ssl-manager trust myapp.local

That's it! Your browser now trusts https://myapp.local 🎉

📋 Commands

Command Description Example
create <domain> Generate a new certificate ./ssl-manager create api.local
trust <domain> Add to system trust store ./ssl-manager trust api.local
list Show all certificates ./ssl-manager list
renew <domain> Refresh before expiry ./ssl-manager renew api.local

🎯 Real-World Example

# Set up your local API
./ssl-manager create api.local
./ssl-manager trust api.local

# Start your server with the generated files
node server.js --cert ~/.ssl-manager/certs/api.local.crt --key ~/.ssl-manager/certs/api.local.key

# ✅ Visit https://api.local - no browser warnings!

📁 Where Are My Certificates?

~/.ssl-manager/certs/
├── api.local.crt     # Certificate file
├── api.local.key     # Private key
├── app.local.crt
└── app.local.key

🔧 How Trust Installation Works

Platform Method Location
macOS security command System Keychain
Windows certutil command ROOT certificate store
Linux Copy + update /usr/local/share/ca-certificates/

💡 Pro Tips

  • Wildcards: Use *.local for subdomain flexibility
  • Batch creation: Script multiple domains for complex setups
  • Expiry monitoring: Run list to check certificate health
  • Team sharing: Commit certificates (not keys!) for consistent dev environments

🆚 vs. Other Tools

Feature ssl-manager mkcert openssl
Setup complexity ✅ Zero config ⚠️ CA setup required ❌ Complex commands
Trust installation ✅ Automatic ✅ Automatic ❌ Manual
Cross-platform ✅ Built-in ✅ Yes ⚠️ Platform-specific
Dependencies ✅ Single binary ⚠️ External tools ✅ Usually installed

🔍 Certificate Details

  • Validity: 1 year from creation
  • Key size: RSA 2048-bit
  • Includes: Custom domain + localhost + 127.0.0.1 + ::1
  • Format: PEM (universal compatibility)

About

A simple tool to create, manage, and trust self-signed SSL certificates for local development.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages