reverted the change and added an explanation why we assume a POSIX shell for this to work

Stefan Melmuk
2026-08-21 07:49:21 +02:00
parent d4451af481
commit 98fe96f2cf
+4 -1
@@ -64,6 +64,9 @@ echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456
# Output: $argon2id$v=19$m=19456,t=2,p=1$cXpKdUxHSWhlaUs1QVVsSStkbTRPQVFPSmdpamFCMHdvYjVkWTVKaDdpYz0$E1UgBKjUCD2Roy0jdHAJvXihugpG+N9WcAaR8P6Qn/8
```
> [!NOTE]
This command assumes a POSIX shell which removes the single quotes around your string (which have been added to prevent variable interpolation when substituting a `$` in the example). So if you are running a non-POSIX shell you might want to run `echo -n 'MySecretPassword'` to check what is passed and remove the single quotes accordingly.
### Using the generated PHC string
Use the generated PHC string as admin token in your environment variable or by passing it the docker/podman CLI command. For `docker-compose.yml` files follow the instructions below.
@@ -72,7 +75,7 @@ If you have configured your Vaultwarden via the `/admin` page, you should paste
<img width="831" height="63" alt="image" src="https://github.com/user-attachments/assets/52bf60df-1880-41b2-aab7-eac9982f7505" />
After you set the PHC string, you can login by using the password you have used to generate the PHC string, e.g. `MySecretPassword` in the example above to login.
After you set the PHC string, you can login by using the password you have used to generate the PHC string, e.g. `MySecretPassword` in the example above to login.
> [!NOTE]
If you can enter the whole `$argon2id$…` PHC string as an admin password you are probably using an outdated version of Vaultwarden that does not support argon2id yet. Make sure you are using at least the [latest version](https://github.com/dani-garcia/vaultwarden/releases/latest).