Configure https certificate for frontend-html development

dev
1

The https certificate error ERR_CERT_AUTHORITY_INVALID has always been a minor problem because we were using the untrusted certificate from the @vitejs/plugin-basic-ssl package.

I recently started getting the ERR_CERT_AUTHORITY_INVALID error with increased frequency.

The problem can be solved by using mkcert. This is fully optional. If you do not generate the certificate with mkcert, the old way using @vitejs/plugin-basic-ssl will still work.

Take these steps to set up the https certificate for local html-frontend development (so not if you run Origam from docker) in Origam version 2025.11 and newer.

  • Open PowerShell as Administrator
  • Install mkcert via Chocolatey
    choco install mkcert -y
  • Configure mkcert
    mkcert -install
  • Create directory origam\frontend-html\certs and navigate to it with powershell
  • Create a certificate for localhost
    mkcert localhost 127.0.0.1 ::1 Make sure the created files in certs\ are:
    • localhost+2.pem (certificate)
    • localhost+2-key.pem (private key)If not, rename them to these names.

When you then run yarn dev you should get no more ERR_CERT_AUTHORITY_INVALID errors.

2