OSS Password Generator

Passphrases, random passwords, and PINs in open source Password Pusher.

This article applies to: OSS Self-Hosted

The Password Pusher generator creates passphrases, random passwords, and PINs. Use Generate Password on text and QR push forms, or POST /api/v2/generate. Generation is not stored until you create a push.

Modes

Mode What you get
Passphrase Dictionary words in English, Spanish, French, German, or Italian, with optional capitalization, digits, and a symbol
Password Random characters with length, character classes, optional Latin/Cyrillic/Greek letters, and ambiguous-character filtering
PIN Digits only

Instance defaults are set with environment variables. Visitors can override them in Configure (saved in cookies).

Environment variables

Environment Variable Description Default
PWP__GEN__DEFAULT_TYPE passphrase, password, or pin passphrase
PWP__GEN__LANGUAGE Default passphrase language: en, es, fr, de, it en
PWP__GEN__PASSWORD__CHARACTER_LENGTH Password length (4–128) 16
PWP__GEN__PASSWORD__UPPERCASE Include uppercase letters true
PWP__GEN__PASSWORD__LOWERCASE Include lowercase letters true
PWP__GEN__PASSWORD__DIGITS Include digits true
PWP__GEN__PASSWORD__SYMBOLS Include symbols !@#$%^&* true
PWP__GEN__PASSWORD__AVOID_AMBIGUOUS Omit I, l, 1, O, 0, o true
PWP__GEN__PASSWORD__CHARSET ascii, latin, cyrillic, or greek ascii
PWP__GEN__PASSPHRASE__WORD_COUNT Word count (3–10) 4
PWP__GEN__PASSPHRASE__SEPARATOR String between words -
PWP__GEN__PASSPHRASE__CAPITALIZE Titlecase each word true
PWP__GEN__PASSPHRASE__NUMBER Append two digits true
PWP__GEN__PASSPHRASE__SYMBOL Append one symbol false
PWP__GEN__PIN__DIGIT_COUNT PIN length (4–12) 6

Legacy syllable settings (PWP__GEN__SYLLABLES_COUNT, consonants, vowels, and related keys) are no longer used.

Word lists

English passphrases use the EFF large wordlist (CC BY 3.0 US). Spanish, French, and Italian use BIP-39 lists. German uses the dys2p de-7776 list.

API

See the in-app API help at /help/api (POST /api/v2/generate) or API v2. count is 1–10 (default 1).