amnezia-wg-easy/How_to_generate_an_bcrypt_hash.md

wg-password

wg-password (wgpw) is a script that generates bcrypt password hashes for use with wg-easy, enhancing security by requiring passwords.

Features

• Generate bcrypt password hashes.
• Easily integrate with wg-easy to enforce password requirements.

Usage with Docker

To generate a bcrypt password hash using docker, run the following command :

docker run ghcr.io/wg-easy/wg-easy wgpw YOUR_PASSWORD
PASSWORD_HASH='$2b$12$coPqCsPtcFO.Ab99xylBNOW4.Iu7OOA2/ZIboHN6/oyxca3MWo7fW' // literally YOUR_PASSWORD

Important: in your configuration, make sure to use double "$", or your password may not work! In the example of password "YOUR_PASSWORD" you may write like this: PASSWORD_HASH=$$2b$$12$$coPqCsPtcFO.Ab99xylBNOW4.Iu7OOA2/ZIboHN6/oyxca3MWo7fW

Important : make sure to enclose your password in single quotes when you run docker run command :

$ echo $2b$12$coPqCsPtcF
b2
$ echo "$2b$12$coPqCsPtcF"
b2
$ echo '$2b$12$coPqCsPtcF'
$2b$12$coPqCsPtcF