Damp

Automatic SSL Certificates

Secure HTTPS for every project with zero configuration

DAMP provides automatic HTTPS for all your local projects using Caddy's built-in certificate authority. No manual configuration, no browser warnings - just secure connections out of the box.

Every project gets HTTPS automatically

Caddy generates and manages SSL certificates for all your sites, giving you a production-like environment locally.

Powered by Caddy

DAMP uses Caddy - a modern web server with automatic HTTPS built in.

Zero Configuration

SSL certificates are generated automatically when you create a new site

Local Certificate Authority

Caddy creates its own trusted CA for local development certificates

Auto Renewal

Certificates are automatically renewed before expiration

Browser Trust

One-time root certificate installation eliminates browser warnings

How It Works

When you create a new site in DAMP, here's what happens:

1. Site Creation
   └─> DAMP creates project: myapp.local


2. Caddy Configuration
   └─> Caddy receives reverse proxy config


3. SSL Generation
   └─> Caddy generates SSL certificate


4. Ready to Use
   └─> Access https://myapp.local securely ✅

Automatic Process

All SSL management happens automatically in the background - you don't need to configure anything.

Certificate Installation

For the best experience, install Caddy's root certificate once:

One-Time Setup

Install Caddy Service

Start Caddy service from the Services page in DAMP. Caddy will automatically create its local certificate authority.

Install Root Certificate

DAMP will attempt to automatically install the root certificate. If automatic installation fails, you can:

  • Click "Install SSL Certificate" button in the Caddy management section
  • Or download the certificate and install it manually

Enjoy Secure Connections

Once installed, all your .local sites will work with HTTPS without browser warnings!

Manual Installation

If automatic installation doesn't work, download the certificate from DAMP and install it as a "Trusted Root Certification Authority" in Windows.

Features

Automatic Certificate Generation

Every site you create automatically gets:

  • ✅ Valid SSL certificate for HTTPS
  • ✅ HTTP/2 support for better performance
  • ✅ Automatic redirects from HTTP to HTTPS
  • ✅ Vite dev server HTTPS support (for React/Vue projects)

Certificate Management

┌─────────────────────────────────────┐
│     Caddy Certificate Authority     │
├─────────────────────────────────────┤
│  📜 Root CA Certificate             │
│     (Installed once on your system) │
└─────────────────────────────────────┘

                │ Signs certificates for:

┌─────────────────────────────────────┐
│       Your Project Certificates     │
├─────────────────────────────────────┤
│  🔒 myapp.local                     │
│  🔒 blog.local                      │
│  🔒 shop.local                      │
│  🔒 api.local                       │
└─────────────────────────────────────┘

Why This Matters

Modern web development requires HTTPS:

  • Service Workers - Only work on HTTPS connections
  • Browser APIs - Many APIs require secure context
  • Mixed Content - Avoid HTTP/HTTPS mixing issues
  • Production Parity - Match your production environment

Without HTTPS locally, you can't test:

  • Progressive Web Apps (PWAs)
  • Web Push Notifications
  • Geolocation APIs
  • Camera/Microphone access
  • And many other modern features

Benefits

For Developers

  • 🚀 Instant Setup - No certificate configuration needed
  • 🔧 No Maintenance - Certificates auto-renew automatically
  • Clean URLs - Use https:// just like production
  • 🧪 Test Modern Features - PWAs, Service Workers, etc.

For Projects

  • 🔐 Secure by Default - Every project gets HTTPS
  • 🎯 Production-Like - Environment matches real deployments
  • HTTP/2 Support - Better performance with multiplexing
  • 🛡️ Security Testing - Test HTTPS-only features locally

Certificate Status

Check your SSL certificate status anytime:

StatusMeaningAction
✅ Certificate AvailableCaddy CA is activeNone needed
✅ Root Certificate InstalledTrusted by your browserNone needed
⚠️ Root Certificate Not InstalledBrowser will show warningsInstall root certificate
❌ Certificate Not AvailableCaddy not runningStart Caddy service

View Certificate Status

Navigate to Services → Caddy Management to see your SSL certificate status and manage certificates.

What About Production?

While DAMP uses Caddy's local CA for development:

  • Different from production - Production uses real certificates (Let's Encrypt)
  • Same behavior - HTTPS works identically in both environments
  • Easy transition - Your app works the same when deployed
  • Best practice - Develop with HTTPS, deploy with HTTPS

Production-Ready Development

By using HTTPS locally, you catch SSL-related issues before deployment, making your development workflow more professional and reliable.

Troubleshooting


Learn More

For advanced Caddy configuration and certificate management, visit the Caddy Documentation.