Damp

Automatic SSL Certificates

Secure HTTPS for every project

DAMP provides automatic HTTPS for all your local projects using Caddy's built-in certificate authority.

Caddy generates and manages SSL certificates for all your projects.

Powered by Caddy

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

Automatic Configuration

SSL certificates generated automatically when you create a new project

Local Certificate Authority

Caddy creates its own CA for local development certificates

Auto Renewal

Certificates automatically renewed before expiration

Browser Trust

One-time root certificate installation

How It Works

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

1. Project 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

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

Certificate Installation

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.

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

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

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

Troubleshooting


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

On this page