# @vitejs/plugin-basic-ssl

> A Vite plugin to generate untrusted certificates for HTTPS dev servers

Latest version **2.3.0** (published 2026-03-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @vitejs/plugin-basic-ssl
pnpm add @vitejs/plugin-basic-ssl
yarn add @vitejs/plugin-basic-ssl
bun add @vitejs/plugin-basic-ssl
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.3.0 |
| Published | 2026-03-24 |
| First published | 2022-07-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^18.0.0 \|\| ^20.0.0 \|\| >=22.0.0 |
| Dependencies | 0 |
| Unpacked size | 608 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 516 |
| Author | Evan You and Vite Contributors |
| Maintainers | yyx990803, patak, antfu, vitebot |
| Keywords | vite, vite-plugin, certificate, https |

## Links

- npm: https://www.npmjs.com/package/@vitejs/plugin-basic-ssl
- Repository: https://github.com/vitejs/vite-plugin-basic-ssl
- Homepage: https://github.com/vitejs/vite-plugin-basic-ssl/#readme
- Issues: https://github.com/vitejs/vite-plugin-basic-ssl/issues
- npm.io page: https://npm.io/package/@vitejs/plugin-basic-ssl

## Alternatives

- [raw-loader](https://npm.io/package/raw-loader.md) — 4.3M weekly downloads
- [plop](https://npm.io/package/plop.md) — 1.4M weekly downloads
- [webpack-deadcode-plugin](https://npm.io/package/webpack-deadcode-plugin.md) — 80.3K weekly downloads
- [@storybook/preact-vite](https://npm.io/package/@storybook/preact-vite.md) — 54.2K weekly downloads
- [vite-plugin-transform](https://npm.io/package/vite-plugin-transform.md) — 2.4K weekly downloads

## Recent versions

- 2.3.0 (latest) — 2026-03-24
- 2.2.0 — 2026-03-12
- 2.1.4 — 2026-01-20
- 2.1.3 — 2026-01-08
- 2.1.2 — 2026-01-08
- 2.1.0 — 2025-07-01
- 2.0.0 — 2025-03-03
- 1.2.0 — 2024-11-27
- 1.1.0 — 2024-01-15
- 1.0.2 — 2023-11-16
- 1.0.1 — 2022-12-09
- 1.0.0 — 2022-12-09
- 0.1.2 — 2022-08-17
- 0.1.1 — 2022-07-06

## README

# @vitejs/plugin-basic-ssl [![npm](https://img.shields.io/npm/v/@vitejs/plugin-basic-ssl.svg)](https://npmjs.com/package/@vitejs/plugin-basic-ssl)

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`](https://vitejs.dev/config/server-options.html#server-https)

## Usage

```js
// 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'],
      /** optional, days before certificate expires */
      ttlDays: 30,
      /** custom certification directory */
      certDir: '/Users/.../.devServer/cert',
    }),
  ],
}
```

## License

MIT

---
_Source: https://npm.io/package/@vitejs/plugin-basic-ssl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._