Skip to content

Get Started English

Jump to bottom
Andreas edited this page Dec 9, 2024 · 22 revisions

Installation of Jitsi Admin

Contributor Covenant Crowdin

This guide describes the steps to install the Jitsi Admin using Docker and Docker-Compose. The easiest way to install the Jitsi Admin is by using the pre-configured Dockerimages and the provided config files. The Composer will setup the Application together with a Treafik Load Balancer, MySQL Database, and Keycloak. Please perform the following steps as the root user.

su root
cd /tmp

Step 1: Install Docker and Docker-Compose

First, you need to configure an APT repository and install Docker and Docker-Compose in the latest version.

wget https://git.h2-invent.com/Meetling/Docker-Compose/raw/branch/main/installDocker.sh
bash installDocker.sh
rm installDocker.sh

Step 2: Set up the configuration for Docker-Compose

Next, set up the configurations for Docker-Compose and deploy the container.

wget https://git.h2-invent.com/Meetling/Docker-Compose/raw/branch/main/setup.sh
bash setup.sh
rm setup.sh

Step 3: Change to the configuration directory and start the container

Now, change to the configuration directory and start the Docker container.

cd /opt/jitsi-admin
docker-compose up -d

Step 4: Set up DNS or local hosts file

To access the Open Datenschutzcenter, you need to adjust your DNS settings or the local hosts file to point the domain to your server. You can use your DNS server to add the URL for the Open Datenschutzcenter or add your DNS entry in the local file on your computer or server.

# /etc/hosts
127.0.0.1       dev.domain.de

Step 5: Register your User account

After completing these steps, you should be able to access the application (e.g. http://dev.domain.de) with any Browser. On the login screen of the application, you can click "Register" to create your first user. After the Registration, you get redirected to the ODC application to create your first Company.

(Optional) Working directory

The setup script will clone and add files into the directory /opt/jitsi-admin.

You can run the composer command inside this directory again to update the containers or check the variables which are used to setup the containers.

cd /opt/jitsi-admin

Following Files are important and have been changed and setup with the script:

  • .env.local
  • docker.config
  • docker-compose.yml

(Optional) Add additional custom configs

To add additional custom environment variables, you can add a file .env.custom and add your variables there. This file will not be changed from the setup script and will be used inside all containers to overwrite the existing .env and .env.local All environment variables can be found here Default ENV inside the Git Repo

MAILER_DSN='smtps://<username>:<password>@<smtpHost>:<smtpPort>'
imprint=test
dataPrivacy=test
helpUrl=https://meetling.de/tutorial-helpcenter/
helpText='<a href="https://meetling.de/tutorial-helpcenter/" target="_blank">Handbuch/Tutorials/FAQ</a>'
helpUrlParticipants=https://meetling.de/tutorial-helpcenter/
CRON_TOKEN=token

(Optional) Final Result

Following final Result should be printed from the docker-compose command:

# docker-compose up -d
Creating network "jitsi-admin_external" with the default driver
Creating network "jitsi-admin_internal" with the default driver
Creating jitsi-admin_traefik-ja_1   ... done
Creating jitsi-admin_db-ja_1        ... done
Creating jitsi-admin_websocket-ja_1 ... done
Creating jitsi-admin_app-ja_1       ... done
Creating jitsi-admin_keycloak-ja_1  ... done
Clone this wiki locally