Intro
Wappler now supports local development using HTTPS out of the box. This is ideal for testing APIs, authentication flows, or any feature that requires a secure connection - all without needing a real domain or external certificate.
[!NOTE]
This feature is available only for Wappler local and Docker targets using Node.js.
Automatic SSL Certificate Generation with mkcert
Wappler integrates the mkcert tool to automatically generate local SSL certificates. You don’t need to install or configure it manually - Wappler will install mkcert automatically the first time it’s needed.
Configuring Local Target for HTTPS
Open your Project Settings:
Open Targets and select your local development target:
Set the Web Server URL to use HTTPS and a custom .localhost domain, for example: https://mysite.localhost:3000
[!NOTE]
By default, local targets usehttp://localhost:3000
To enable HTTPS, change it to use:
https://+ your site name +.localhost+:3000
(e.g.https://mysite.localhost:3000)The
.localhostdomain always points to your local machine, and using it allows Wappler to generate a valid SSL certificate for that domain.
Click Save:
Wappler will automatically generate and install the SSL certificate. A notification will appear confirming that the SSL certificate was generated successfully.
After this, your local site is ready to be accessed securely over HTTPS:
You’re all set!
With HTTPS enabled for your local target, you can now develop and test secure features locally, just like on a real production server - but with the convenience and speed of your local machine.