Vaultwarden on Cloudron initial setup

[LoudLemur]

https://docs.cloudron.io/apps/vaultwarden/

The instructions on the support page are difficult to follow / don't work:

If you type the following, nothing happens:

app/code/vaultwarden hash

same with the following:

vaultwarden

and this:

vaultwarden hash

and also this:

Generate an Argon2id PHC string using the 'bitwarden' preset:

What do we actually need to do? Also, could we include a quick animated gif for each application demonstrating the setup procedure?

[robi]

it should say run ./vaultwarden hash as the web terminal drops you in /app/code/ by default.

[LoudLemur]

@robi said in Vaultwarden on Cloudron initial setup:

it should say run ./vaultwarden hash as the web terminal drops you in /app/code/ by default.

@robi, you are great!

[robi]

@staff please do a doc fix on the above

[jdaviescoates]

@robi said in Vaultwarden on Cloudron initial setup:

@staff please do a doc fix on the above

There is actually already a pull request from @necrevistonnezr that fixes this:

https://git.cloudron.io/necrevistonnezr/docs/-/compare/master...105912c6569b655649989167ad84594a412c8292?from_project_id=311

(after I had similar issues https://forum.cloudron.io/post/66377 )

[necrevistonnezr]

Maybe I forgot to create a merge request? I just created (a new?) one.

I somehow don't understand Gitlab - well, I'm not really a programmer.

[nebulon]

There was one which was empty and I have closed it now. Alternately you could also send us the changes directly and we will integrate them.

[necrevistonnezr]

Is it ok like this: https://paste.cloudron.io/ahotevaboc.md (Patch via your hastebin)?

[nebulon]

For some reason that diff does not really match the latest docs version, but I pushed a change to fix the ./vaultwarden hash command as you also have in the diff. Not sure if this was really all in the end.

[robi]

@nebulon the docs are still not right, as what's in the docs (img below) is not what a user will see when they open the web terminal.

should be more like:

root@abc:/app/code# ./vaultwarden hash

[girish]

@robi i had changed it to be absolute path. What is wrong with the path?

[necrevistonnezr]

Users may not understand that they either have to copy & past the whole /app/code/vaultwarden hash into the command line OR just ./vaultwarden hash

[nebulon]

if both works, I don't quite see the issue here, or is one not working as expected?

[LoudLemur]

@necrevistonnezr said in Vaultwarden on Cloudron initial setup:

Users may not understand that they either have to copy & past the whole /app/code/vaultwarden hash into the command line OR just ./vaultwarden hash

Trying this didn't work: /app/code/vaultwarden hash

As @robi said, using the following command does: ./vaultwarden hash

I think part of the problem in this case is not having a clear policy about how to represent commands in the documentation.

[necrevistonnezr]

@LoudLemur Weird. If I open up the Web Terminal for Vaultwarden and copy & past /app/code/vaultwarden hash (the whole thing!), it works for me:

[girish]

I just double checked this. It works fine even when run from /tmp as current directory.

root@bb442c5d-ba11-4a7f-b4ff-663720abdc2f:/tmp# /app/code/vaultwarden hash
Generate an Argon2id PHC string using the 'bitwarden' preset:

Password: 
Confirm Password: 

ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$vIlWyi0mBy4yIEnMZB54VWRjZN+sbamxAvvVy+ORGf0$IfU/tB2ULY97ccACP0444mSmm6rCORIWraTApg4E5uA'

Generation of the Argon2id PHC string took: 268.843761ms

[robi]

@girish while you may know how to make it work from any directory, the average user perspective is a very point-and-click one with direct comparison to what they see in their terminal and your docs.

So all the variations you give are just adding confusion, as it doesn't match what they see once they click the web terminal button and the new tab opens.

Hence the docs need instructions as compared to the default experience users see.

Is that clearer?

[girish]

@robi sure. But absolute paths are the correct paths to use in docs. We don't use relative paths (when we do, we also put a cd command before that). relative paths depend on the the package WORKDIR from Dockerfile as well.

[LoudLemur]

I think the documentation should present the necessary command in isolation.

This should then be accompanied by an sort of screenshot image of what the user can expect to see when they attempt it, the context and perhaps the results after successfully using the command.

Currently, what Cloudron documentation shows is only the last part, what one might see in the terminal.

The markdown used to create this could be more clear. Different use of colour could be used to indicate:

• the commands to be typed into the terminal
• the prompt/path
• the results from using the command

I will have a look around for some better custom markdown. Somebody might know some good stuff already.

root@bb442c5d-ba11-4a7f-b4ff-663720abdc2f:/tmp# /app/code/vaultwarden hash
Generate an Argon2id PHC string using the 'bitwarden' preset:

Password: 
Confirm Password: 

ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$vIlWyi0mBy4yIEnMZB54VWRjZN+sbamxAvvVy+ORGf0$IfU/tB2ULY97ccACP0444mSmm6rCORIWraTApg4E5uA'

Generation of the Argon2id PHC string took: 268.843761ms

If the documentation presents the information like this, the user has to know that there is a:

• distinction between the current path being indicated and the command itself
• how to extract the command from the other information.

If users trying to follow the documentation don't realize this, then they may attempt to follow the instructions by trying to copy/paste like this into the terminal:

root@bb442c5d-ba11-4a7f-b4ff-663720abdc2f:/tmp# /app/code/vaultwarden hash

or they might even try and copy paste this:

root@bb442c5d-ba11-4a7f-b4ff-663720abdc2f:/tmp# /app/code/vaultwarden hash
Generate an Argon2id PHC string using the 'bitwarden' preset:

or this:

Generate an Argon2id PHC string using the 'bitwarden' preset:

[LoudLemur]

Here is a quick example of well regarded documentation from the Django framework:

You can see that the command is highlighted in bold, and then the view in the shell is presented, too.