Questo repository permette di creare velocemente una nuova istanza di Jitsi Meet da aggiungere al progetto.
Per creare la tua installazione segui questi semplici passi:
e comunicaci la tua intenzione di creare un server
ti faremo alcune domande e ti aiuteremo durante la procedura di installazione.
Puoi usare qualsiasi distribuzione GNU/Linux, avrai bisogno di installare solo docker, docker-compose e git.
Per installare Docker, ti consiglio di seguire la guida ufficiale:
https://docs.docker.com/install/
Per installare Docker Compose, allo stesso modo, attieniti alla guida ufficiale:
https://docs.docker.com/compose/install/
Per garantire un servizio migliore abbiamo stabilito i seguenti requisiti minimi:
• una macchina dedicata allo scopo, non condivisa con altri servizi.
- IPv4 statico (possibilmente in un datacenter italiano)
- connessione 100 Mbps simmetrica (meglio 1 Gbps, ogni utente occupa circa 4 Mbps)
- 4 CPU server grade (Xeon o analogo)
- 4GB di RAM
Server posizionati in datacenter italiani riducono latenza e congestione di rete.
Naturalmente un server più grande riuscirà ad ospitare più utenti!
cd /opt
git clone https://github.com/iorestoacasa-work/docker-jitsi-meet.git
cd docker-jitsi-meet
copia il file di configurazione di esempio env.example in .env
cp env.example .env
modifica il file .env ed inserisci i valori adeguati alla tua installazione.
Alcuni consigli:
PUBLIC_URL deve contenere l'URL della tua installazione, ad esempio https://mioserver.iorestoacasa.work
ENABLE_LETSENCRYPT=1 se vuoi generare il certificato con Let's Encrypt
LETSENCRYPT_DOMAIN deve contenere il nome di dominio per cui generare il certificato, ad esempio mioserver.iorestoacasa.work
IMPORTANTE: devi sostituire tutte le occorrenze di meet.jitsi nel file .env con il tuo nome di dominio, ad esempio mioserver.iorestoacasa.work
Se hai dubbi, chiedi aiuto nella chat Telegram.
Una volta modificato il file, genera i token di sicurezza lanciando il comando:
./gen-passwords.sh
Tieni presente che modificando la porta HTTP, modificherai la porta di ascolto del server web che però deve essere esposta su Internet alla porta 80, altrimenti non riuscirai ad ottenere il certificato Let's Encrypt con questa installazione. Ti consigliamo di non cambiarla.
Configura il parametro ENABLE_RECORDING=1 nel file .env
Carica il modulo del kernel snd_aloop e configuralo come indicato nella guida ufficiale.
Lanciando:
docker-compose up -d
Oppure, se hai scelto di usare Jibri per abilitare lo streaming e la registrazione lancia:
docker-compose -f docker-compose.yml -f jibri.yml up -d
questo comando avvia il server in background, quindi potrai chiudere la shell.
Per verificare che il servizio sia attivo puoi usare il comando
docker-compose ps
Per leggere i log usa
docker-compose logs -f --tail=10
Se hai un firewall attivo, assicurati che siano aperte le porte:
- 80/tcp (Web UI HTTP - usata solo per il redirect da HTTP ad HTTPS)
- 443/tcp (Web UI HTTPS)
- 4443/tcp (RTP media over TCP)
- 10000/udp (RTP media over UDP)
- 8081/tcp (metriche)
apri l'URL della tua istanza con il browser sulla porta 80 e 443.
verifica che il certificato HTTPS sia stato generato correttamente (lucchetto verde)
verifica che le metriche vengano generate correttamente, visitando con il browser l'URL del tuo server sulla porta 8081 (HTTP!)
prova a creare una stanza, se riesci a vedere la tua faccia complimenti, sei riuscito ad installare Jitsi!
partendo da questo template
aggiungeremo prima possibile il tuo server alla tabella sul sito https://iorestoacasa.work.
Di solito ci dedichiamo a questa attività mezz'ora dopo pranzo.