help icon indicating copy to clipboard operation
help copied to clipboard

Instructions unclear how to install bitwarden behind a existing reverse proxy

Open LeducH opened this issue 4 years ago • 4 comments

Describe the Bug

Instructions unclear how to install bitwarden behind a existing reverse proxy

Steps To Reproduce

Read manual install

Expected Result

it would be clear how to set up the bitwarden behind a reverse proxy

Actual Result

step 6 and 10 are unclear. These steps could be optional or elaborated.

Many users have their own reverse proxy such as nginx and just like to have a simple instance running under a specific port. The steps are rather unclear why they are done and what can be omitted behind a reverse proxy.

This seems to be a very common use case but there is no clear explanation how this can be achieved.

LeducH avatar May 13 '21 06:05 LeducH

If you are running both, the reverse proxy as well as bitwarden on the same server, you can just disable TLS for Bitwarden and implement it on the reverse proxy. Check your config.yml for https_port:, ssl: false, and ssl_managed_lets_encrypt: false.

c4539 avatar Jun 01 '21 19:06 c4539

@fschillingeriv - is this something our docs should cover in more detail, or is it out of scope?

eliykat avatar Jun 01 '21 22:06 eliykat

I recently installed Bitwarden on a new server and have the process fresh in my head. It took me a while to figure out the best way to install with nginx as reverse proxy. Specifically, I think the documentation should include the 'correct' answers for the install script questions if you plan to set up nginx and manage your own certs via certbot after the BW set up is completed (so, no to TLS certificates, no to providing the path to certificates). I also ran into an issue where my URI had been set to http:// instead of https://, and I hadn't noticed, which caused problems until I figured it out, so maybe the default URI set in global.override.env should always be https:// or alternatively a message presented to the user during installation, in the same place where it shows the message that says BW will not work properly without TLS.

dinosmm avatar Sep 20 '21 09:09 dinosmm

Moving this to our help repo as this primarily seems to be about documentation.

eliykat avatar Sep 21 '21 00:09 eliykat