MirrorMirror
/
PairDrop
mirror of https://github.com/schlagmichdoch/PairDrop.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix dev environment variable FQDN missing and update docs

This commit is contained in:
schlagmichdoch 2024-07-17 15:37:39 +02:00
parent 331c61fec8
commit f9b8b0fadf
3 changed files with 12 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

@ -1,6 +1,5 @@
node_modules node_modules
.DS_Store .DS_Store
fqdn.env
/dev/certs /dev/certs
qrcode-svg/ qrcode-svg/
turnserver.conf turnserver.conf

3
docker-compose-dev.yml
View File

@ -27,7 +27,8 @@ services:
ports: ports:
- "8080:80" - "8080:80"
- "8443:443" - "8443:443"
env_file: dev/fqdn.env environment:
- FQDN=localhost
entrypoint: /mnt/openssl/create.sh entrypoint: /mnt/openssl/create.sh
command: ["nginx", "-g", "daemon off;"] command: ["nginx", "-g", "daemon off;"]
restart: unless-stopped restart: unless-stopped

15
docs/host-your-own.md
View File

@ -685,8 +685,8 @@ PWAs requires the app to be served under a correctly set up and trusted TLS endp
The NGINX container creates a CA certificate and a website certificate for you. The NGINX container creates a CA certificate and a website certificate for you.
To correctly set the common name of the certificate, To correctly set the common name of the certificate,
you need to change the FQDN environment variable in `docker/fqdn.env` you need to change the FQDN environment variable in `docker-compose-dev.yml`
to the fully qualified domain name of your workstation. to the fully qualified domain name of your workstation. (Default: localhost)
If you want to test PWA features, you need to trust the CA of the certificate for your local deployment. \ If you want to test PWA features, you need to trust the CA of the certificate for your local deployment. \
For your convenience, you can download the crt file from `http://<Your FQDN>:8080/ca.crt`. \ For your convenience, you can download the crt file from `http://<Your FQDN>:8080/ca.crt`. \
@ -700,10 +700,15 @@ Install that certificate to the trust store of your operating system. \
- expand `Trust`, and select `Always Trust` for SSL. - expand `Trust`, and select `Always Trust` for SSL.
##### Firefox ##### Firefox
- Firefox uses its own trust store. To install the CA, Firefox uses its own trust store. To install the CA:
- point Firefox at `http://<Your FQDN>:8080/ca.crt`. - point Firefox at `http://<Your FQDN>:8080/ca.crt` (Default: `http://localhost:8080/ca.crt`)
- When prompted, select `Trust this CA to identify websites` and click _OK_. - When prompted, select `Trust this CA to identify websites` and click _OK_.
Alternatively:
1. Download `ca.crt` from `http://<Your FQDN>:8080/ca.crt` (Default: `http://localhost:8080/ca.crt`)
2. Go to `about:preferences#privacy` scroll down to `Security` and `Certificates` and click `View Certificates`
3. Import the downloaded certificate file (step 1)
##### Chrome ##### Chrome
- When using Chrome, you need to restart Chrome so it reloads the trust store (`chrome://restart`). - When using Chrome, you need to restart Chrome so it reloads the trust store (`chrome://restart`).
- Additionally, after installing a new cert, you need to clear the Storage (DevTools → Application → Clear storage → Clear site data). - Additionally, after installing a new cert, you need to clear the Storage (DevTools → Application → Clear storage → Clear site data).
@ -715,6 +720,6 @@ Install that certificate to the trust store of your operating system. \
Please note that the certificates (CA and webserver cert) expire after a day. Please note that the certificates (CA and webserver cert) expire after a day.
Also, whenever you restart the NGINX Docker container new certificates are created. Also, whenever you restart the NGINX Docker container new certificates are created.
The site is served on `https://<Your FQDN>:8443`. The site is served on `https://<Your FQDN>:8443` (Default: `https://localhost:8443`).
[< Back](/README.md) [< Back](/README.md)