Meeting Rooms Installation & Upgrade



The Meeting Rooms is an enterprise version feature. To enable it, please contact XiVO team.


The Meeting Rooms components works only if you have the XiVO Edge component installed and configured.

Server Requirements

The Meeting Rooms components must be installed on a different server as the XiVO CC/UC server.

The minimal requirements would be:

  • OS: Debian 12 (Bookworm), 64 bits

  • CPU: 4 CPU

  • RAM: 8 Gb


Base installation

1. Docker & Docker compose Installation

These commands will install docker and docker compose on the host.

# Install docker prerequisites
apt install wget dirmngr gnupg ca-certificates ntp curl

# Install docker
curl -fsSL | apt-key --keyring ${DOCKER_KEYRING_FILE} add -
echo "deb bookworm stable" > /etc/apt/sources.list.d/docker.list
cat > /etc/apt/preferences.d/docker-ce <<EOF
Package: docker-ce*
Pin: version 5:25.0.5*
Pin-Priority: 1000

apt update
apt install docker-ce

#Install docker compose v2
apt update
apt install docker-compose-plugin

2. XiVO Meeting Rooms Launcher Setup

  1. Create meetingrooms directory:

    mkdir -p /etc/docker/meetingrooms
  2. Download XiVO Meeting Rooms configuration. In the following script replace TAG_OR_BRANCH by the name of a tag or a branch.


    currently to install the latest stable version of maia, use TAG_OR_BRANCH=2024.05.02

    cd /etc/docker/meetingrooms
    wget "${TAG_OR_BRANCH}/${TAG_OR_BRANCH}.tar.gz"
    tar -zxvf ${TAG_OR_BRANCH}.tar.gz -C /etc/docker/meetingrooms --strip-components 1
    rm ${TAG_OR_BRANCH}.tar.gz
  3. Create the jitsi configuration directory:

    cd /etc/docker/meetingrooms
    mkdir -p jitsi/{web/letsencrypt,transcripts,prosody/config,prosody/prosody-plugins-custom,jicofo,jvb,jigasi,jibri}
  4. Create bash alias to launch services:

    echo "alias meetingrooms-dcomp='docker compose -p meetingrooms -f /etc/docker/meetingrooms/xivo-meetingrooms.yml --env-file=/etc/docker/meetingrooms/.env'" >> ~/.bashrc
    source ~/.bashrc

3. Next step

Congrats: You’re done with the Meeting Rooms Installation.


Currently there is no automatic upgrade process. Here is the manual process that you need to follow on the Meeting Room server.

  • Make a backup of the Meeting Room launcher:

    cp -aR /etc/docker/meetingrooms/ /var/tmp/meetingrooms-backup/
  • Re-install the Meeting Room Launcher (it will override the .yml files): follow the 2. XiVO Meeting Rooms Launcher Setup steps to install new version


    This step overrides the current .yml files. If you had made some customization in them you will have to backport them by comparing the new one with the backup you did at previous step.

  • And then verify that the content of the .env file is correct:

    • Compare the old version and what is defined in the Meeting Rooms Configuration section.

    • Verify that the XIVOCC_TAG and XIVOCC_DIST correspond to what you want to install (it should be 2024.05 and latest).

  • Finally pull the new images and restart the containers:


    it will stop all Meeting Room calls (and disconnect users from the application).

    docker login -u xivoxc
    (use the token provided by the XiVO team)
    meetingrooms-dcomp pull && docker logout
    meetingrooms-dcomp up -d