From f7d49fa066b362da2706ad812d25d59aac646a78 Mon Sep 17 00:00:00 2001 From: Aetherinox Date: Sun, 1 Dec 2024 18:24:18 -0700 Subject: [PATCH] docs(readme): add certificate info --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/README.md b/README.md index 413b8964..bdb25c74 100644 --- a/README.md +++ b/README.md @@ -59,6 +59,7 @@ Makes use of the generous work over at [https://github.com/dtankdempse/thetvapp- - [Troubleshooting](#troubleshooting) - [Permission Denied](#permission-denied) - [Shell / Bash](#shell--bash) +- [SSL Certificates](#ssl-certificates) - [Logs](#logs) - [Contributors ✨](#contributors-) @@ -497,6 +498,45 @@ docker exec -it thetvapp ash
+## SSL Certificates +This docker image automatically generates an SSL certificate when the nginx server is brought online. + +
+ +

+ +
+ +You may opt to either use the generated self-signed certificate, or you can add your own. If you decide to use your own self-signed certificate, ensure you have mounted the `/config` volume in your `docker-compose.yml`: + +```yml +services: + thetvapp: + container_name: thetvapp + image: ghcr.io/aetherinox/thetvapp-docker:latest # Github image + restart: unless-stopped + volumes: + - ./thetvapp:/config +``` + +
+ +Then navigate to the newly mounted folder and add your `📄 cert.crt` and `🔑 cert.key` files to the `📁 /thetvapp/keys/*` folder. + +
+ +> [!NOTE] +> If is recommended if you are generating your own SSL certificate and keys, you use a minimum of: +> - RSA: `2048 bits` +> - ECC: `256 bits` +> - ECDSA: `P-384 or P-521` + +
+ +--- + +
+ ## Logs This image spits out detailed information about its current progress. You can either use `docker logs` or a 3rd party app such as [Portainer](https://portainer.io/) to view the logs.