Setting up Dev Server with HTTPS Proxy On Windows

hint:

If you are a macOS user, you should check the following setup for Mac - Setting up Dev Server with HTTPS Proxy on MacOS.

Most apps are served via HTTP during development. With Storyblok v2, your app must be served in HTTPS proxy for your development server on Windows.

  • Install Chocolatey: a package manager for windows. You can view installation guides here.

  • Install mkcert for creating a valid certificate and install localhost with mkcert: Open your PowerShell as admin and run the commands below consecutively; make sure that Chocolatey

    choco install mkcert // install mkcert
    mkcert --version // check the mkcert version
    IMPORTANT:

    For some users, install local-ssl-proxy package globally on your windows machine, as adding it to package.json script might not work.

  • Add the proxy to your package.json scripts: Next, add the commands below to your package.json scripts

    "proxy": "mkcert -install && mkcert localhost && local-ssl-proxy --source 3010 --target 3000 --cert localhost.pem --key localhost-key.pem"

  • Run the proxy with the command below:

    yarn proxy 
  • In a separate terminal, start your application by running

    yarn dev
IMPORTANT:

Add this to your project’s to gitignore

# HTTPS Proxy certificates
localhost.pem
localhost-key.pem