From aa38a7e06548239acf7043205790ba8983264478 Mon Sep 17 00:00:00 2001 From: ediblerope Date: Tue, 7 Apr 2026 21:00:03 +0100 Subject: [PATCH] Document Authelia users_database.yml structure and password hash generation Co-Authored-By: Claude Opus 4.6 --- readme.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/readme.md b/readme.md index f79c4f3..17d7a11 100644 --- a/readme.md +++ b/readme.md @@ -191,8 +191,18 @@ echo -n 'random-storage-encryption-key' | sudo tee /var/secrets/authelia/storag sudo chmod 600 /var/secrets/authelia/* # Authelia user database (for a fresh install) +# Create users_database.yml with this structure: +# --- +# users: +# username: +# password: "$argon2id$..." # hashed — see below +# displayname: Display Name +# email: user@example.com +# +# Generate a password hash with: +# nix-shell -p authelia --run "authelia crypto hash generate argon2" sudo mkdir -p /var/lib/authelia-main -sudo cp users_database.yml /var/lib/authelia-main/ +sudo nano /var/lib/authelia-main/users_database.yml sudo chown authelia-main:authelia-main /var/lib/authelia-main/users_database.yml ```