# Deploy Pwgen with Easypanel

URL: /templates/pwgen

Pwgen is a simple, self-hosted web application for generating secure passwords and passphrases with customisable options. Users can generate random passwords with configurable length and character sets (uppercase, digits, special characters, homoglyph exclusion) or word-based passphrases with choices of separator, capitalisation, and word count. All generated passwords are optionally cross-checked against the haveibeenpwned database to confirm they have not appeared in known data breaches. The app is a single container with no database and supports a PWA install for offline use.

## Installation notes

Open the app at your domain. Configure your desired password or passphrase options using the toggles and sliders, then click Generate. Click "copy password" to copy the result to your clipboard. By default the app checks generated passwords against the haveibeenpwned API. Set NO_API_CHECK=true (the default in this template) to disable that check for air-gapped or privacy-sensitive deployments.

## Benefits

### No Account, No Cloud

Pwgen runs entirely in a single container with no external database or account required. Generated passwords never leave your server unless you choose to check them against haveibeenpwned.

### HaveIBeenPwned Integration

Optionally cross-references every generated password against the haveibeenpwned breach database using a k-anonymity API call so the full password is never transmitted.

### Flexible Generation

Supports both random character passwords and word-based passphrases with English, Finnish, and French wordlists as well as custom wordlists from URLs or local files.

## Features

### Password Generation

Configurable length (slider), uppercase letters, digits, special characters, and optional homoglyph exclusion (removes look-alike characters such as 0/O and 1/l).

### Passphrase Generation

Word-count control, capitalisation toggle, separator choice (space, dash, number, special character, or user-defined), and optional inclusion of numbers or special characters between words.

### Multiple Generation

Generate up to 5 passwords or passphrases simultaneously with the MULTI_GEN option so you can pick the one you prefer.

### Browser Settings Persistence

Saves all generation preferences in a browser cookie so your settings are remembered between visits.

### Progressive Web App

Installable as a PWA for an app-like experience on mobile and desktop without needing a native install.

## Configuration

- `appServiceName` (App Service Name, required): pwgen

- `appServiceImage` (App Service Image, required): jocxfin/pwgen:v1.92.5

- `noApiCheck` (Disable HaveIBeenPwned API Check): true — When enabled, skips the online check against the haveibeenpwned database. Recommended for air-gapped networks or enhanced privacy.

- `pwLength` (Default Password Length): 12

- `pwIncludeUppercase` (Include Uppercase Letters by Default): true

- `pwIncludeDigits` (Include Digits by Default): true

- `pwIncludeSpecial` (Include Special Characters by Default): true

- `multiGen` (Enable Multiple Generation (up to 5 at once)): true

## Services

- pwgen: app (jocxfin/pwgen:v1.92.5)

## Resources

- [Website](https://pwgen.joonatanh.com)

- [GitHub](https://github.com/jocxfin/pwgen)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/pwgen)