Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@vitejs/plugin-basic-ssl

vitejs15.1mMIT2.1.3TypeScript support: included

A Vite plugin to generate untrusted certificates for HTTPS dev servers

vite, vite-plugin, certificate, https

readme

@vitejs/plugin-basic-ssl npm

A plugin to generate untrusted certificates which still allows to access the page after proceeding a wall with warning.

In most scenarios, it is recommended to generate a secure trusted certificate instead and use it to configure server.https

Usage

// vite.config.js
import basicSsl from '@vitejs/plugin-basic-ssl'

export default {
  plugins: [
    basicSsl({
      /** name of certification */
      name: 'test',
      /** custom trust domains */
      domains: ['*.custom.com'],
      /** custom certification directory */
      certDir: '/Users/.../.devServer/cert',
    }),
  ],
}

License

MIT

changelog

2.1.3 (2026-01-08)

Continuous Integration

2.1.2 (2026-01-08)

Miscellaneous Chores

  • add "type": "module" and fix publishing (135a6c2)

2.1.1 (2026-01-08)

Miscellaneous Chores

  • add description and keywords field to package.json (#90) (20a8d50)
  • deps: update actions/checkout action to v5 (#77) (3bca592)
  • deps: update actions/checkout action to v6 (#87) (481d3d6)
  • deps: update actions/setup-node action to v5 (#79) (c07b128)
  • deps: update actions/setup-node action to v6 (#81) (9dc145c)
  • deps: update all non-major dependencies (#75) (851240a)
  • deps: update all non-major dependencies (#84) (5c1d069)
  • deps: update all non-major dependencies (#89) (b6674d5)
  • deps: update dependency @types/node to v24 (#86) (6acab30)
  • deps: update dependency node-forge to v1.3.2 [security] (#88) (415c639)
  • deps: update dependency vite to v7 (#76) (7e86f46)
  • deps: update dependency vite to v7.1.11 [security] (#80) (8c44d82)
  • deps: update dependency vitest to v4 (#85) (5be25be)
  • fix changelog (ab7e865)

Continuous Integration

2.1.0 (2025-07-01)

Features

  • support Vite v7 as a peer dependency (#74) (41c66b8)

2.0.0 (2025-03-03)

Breaking Changes

  • only support vite 6+ and node 18+ (#69) (262fc7a)
  • remove localhost.localdomain from the certificate (#68) (15f129a)
  • remove lvh.me from the certificate (#67) (59e7d71), closes #65

1.2.0 (2024-11-27)

Bug Fixes

  • update unbuild to 2.0.0, fix type declarations for ESM (#28) (2266824), closes #24

Features

1.1.0 (2024-01-15)

Features

1.0.2 (2023-11-16)

Features

1.0.1 (2022-12-09)

Bug Fixes

Features

  • change config hook to configResolved, avoid cacheDir different … (#4) (8df71db)

1.0.0 (2022-12-09)

  • Support Vite 3 and 4.

0.1.2 (2022-08-17)

0.1.1 (2022-07-06)

Features

  • plugin basic ssl, initial commit (c80acb5)