update README.md

README.md

@@ -1,39 +1,80 @@
-# Jitsi Meet on Docker
+# Jitsi Meet Docker Deployment
 
-![](resources/jitsi-docker.png)
+This repository provides a ready-to-deploy, dockerized setup for Jitsi Meet. It is based on the official Jitsi Docker release with specific modifications to accommodate custom SSL certificates and specific environments.
 
-[Jitsi](https://jitsi.org/) is a set of Open Source projects that allows you to easily build and deploy secure videoconferencing solutions.
+![intro](./screenshots/intro.png)
 
-[Jitsi Meet](https://jitsi.org/jitsi-meet/) is a fully encrypted, 100% Open Source video conferencing solution that you can use all day, every day, for free — with no account needed.
+## Features
+- Fully dockerized deployment.
+- Pre-configured volume mapping for custom SSL certificates.
+- Minimal configuration required.
 
-This repository contains the necessary tools to run a Jitsi Meet stack on [Docker](https://www.docker.com) using [Docker Compose](https://docs.docker.com/compose/).
+## Prerequisites
+- Docker and Docker Compose installed on your server.
+- Custom SSL certificates (e.g., from your CDN provider).
+- A domain name pointing to your server's IP address.
 
-All our images are published on [DockerHub](https://hub.docker.com/u/jitsi/).
+## Quick Start
 
-## Supported architectures
+### 1. Configure Environment Variables
+Copy the sample environment file and create your own `.env` file:
+```bash
+cp env.sample .env
+```
 
-Starting with `stable-7439` the published images are available for `amd64` and `arm64`.
+Open `.env` in your preferred text editor and modify the following essential variables:
+```env
+# Exposed HTTP port
+HTTP_PORT=80
 
-## Tags
+# Exposed HTTPS port
+HTTPS_PORT=443
 
-These are the currently published tags for all our images:
+# Public URL of your Jitsi Meet instance
+PUBLIC_URL=https://meet.yourdomain.com
 
-Tag | Description
--- | --
-`stable` | Points to the latest stable release
-`stable-NNNN-X` | A stable release
-`unstable` | Points to the latest unstable release
-`unstable-YYYY-MM-DD` | Daily unstable release
-`latest` | Deprecated, no longer updated (will be removed)
+# Disable Let's Encrypt automatic SSL (since we use custom certs)
+ENABLE_LETSENCRYPT=0
 
-## Installation
+# Enable redirect http to https
+ENABLE_HTTP_REDIRECT=1
+```
 
-The installation manual is available [here](https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker).
+### 2. Configure Custom SSL Certificates
+The `docker-compose.yml` is already modified to accept custom SSL certificates. You just need to place your certificates in the correct directory.
 
-### Kubernetes
+Create the configuration directory:
+```bash
+mkdir -p ~/.jitsi-meet-cfg/web/certs
+```
 
-If you plan to install the jitsi-meet stack on a Kubernetes cluster you can find tools and tutorials in the project [Jitsi on Kubernetes](https://github.com/jitsi-contrib/jitsi-kubernetes).
+Copy your certificate files to the newly created directory (adjust the source paths to match your actual files):
+```bash
+cp /path/to/your/fullchain.pem ~/.jitsi-meet-cfg/web/certs/cert.crt
+cp /path/to/your/private.key ~/.jitsi-meet-cfg/web/certs/cert.key
+```
 
-## TODO
+Set the appropriate permissions for the security keys:
+```bash
+chmod 644 ~/.jitsi-meet-cfg/web/certs/cert.crt
+chmod 600 ~/.jitsi-meet-cfg/web/certs/cert.key
+```
 
-* Builtin TURN server.
+### 3. Generate Passwords and Run
+Jitsi requires internal passwords to securely connect its different components. Generate these automatically by running:
+```bash
+./gen-passwords.sh
+```
+
+Finally, start the deployment in detached mode:
+```bash
+docker compose up --build -d
+```
+
+Your Jitsi Meet instance should now be accessible at your configured `PUBLIC_URL`.
+
+## Client Applications
+
+![app](./screenshots/app.png)
+
+Jitsi Meet is cross-platform. Once your server is up and running, users can connect via standard web browsers or download the official desktop and mobile applications for Windows, macOS, Linux, Android, and iOS from the official Jitsi website.