Forge Home


This module allows you to install Openvidu-server and dependencies


1,466 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.9 (latest)
  • 0.1.8
  • 0.1.7
  • 0.1.6
  • 0.1.5
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.1 (deleted)
  • 0.1.0 (deleted)
released Oct 26th 2020
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'alisio-openvidu', '0.1.9'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add alisio-openvidu
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install alisio-openvidu --version 0.1.9

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



alisio/openvidu — version 0.1.9 Oct 26th 2020

Openvidu Server

Table of Contents

  1. Description
  2. Setup - The basics of getting started with openvidu
  3. Usage
  4. Limitations
  5. Development


This module allows you to install Openvidu-server and its dependencies. You will be able to deploy an OpenVidu based video conference server.

For more info on OpenVidu, please refer to the project documents website. This module as loosely based on the "Deploying OpenVidu on Ubuntu" document


What openvidu affects

The following package and dependencies are installed:

  • kurento-media-server
  • coturn
  • redis-server
  • openjdk-8-jre
  • unzip
  • Docker (service is needed for video recording and it is installed)

Beginning with openvidu

To install an openvidu server:

class {'openvidu':
  public_ip          => '',
  network_interfaces => 'eth0',
  secret             => 'MY_SECRET',




  • public_ip - The public IP address of your server. No default
  • public_url - The public url address of your server (string). Default is the public ip
  • network_interfaces - The network interfaces listening (csv list). Default 'eth0'
  • docker_repo_install - Control docker installation (true). Use it according yo your needs. Default 'true
  • install_path - The OpenVidu install path (string). Default '/opt/openviduserver'
  • jks_path - Path for using custom JKS certificate
  • jks_alias - Alias for the custom JKSPassword for the custom JKS
  • jks_store_password - Password for the custom JKS
  • kms_repo_install - Control kms repo install (boolean). Default to true
  • openvidu_version - The version of the Kurento-media-server (string). Default '2.12.0'
  • kms_version - The version of the Kurento-media-server (string). Default '6.13.0'
  • kms_uris - KMS URL's to which OpenVidu Server will try to connect. They are tested in order until a valid one is found (array). Default Value ''
  • logfile - The OpenVidu logfile path (string). Default '/var/log/openvidu.log'
  • logfile_error - The OpenVidu error logfile path (string). Default '/var/log/openvidu_error.log'
  • recording - Enable or disable video recording (boolean). Default true
  • recording_autostop - Time in seconds to stop recording a finalized conference (integer). Default '0'
  • recording_path - Path where the video files are recorded (string). Default '/opt/openviduserver/recording'
  • secret - Openvidu APP Secret (string). Default 'MY_SECRET'
  • turnserver_enabled - Enable or disable the included COTURN server
  • webhook - set it to true (boolean) to enable webhook service. Default false
  • webhook_endpoint - configure the HTTP endpoint where OpenVidu Server will send the POST messages with session events. Default 'http://localhost:8080/api/webhook/recordingStatusChanged'
  • webhook_headers - an array of HTTP headers that OpenVidu Server will append to each POST message. Default '["recording-path: /opt/openvidu/recording"]'
  • webhook_events - an array with the type of events you want OpenVidu Server to send to your webhook. Default '["recordingStatusChanged"]'


This module is tested on the following platforms:

  • Ubuntu 18.04


Project URL:

Copyright 2019 Antonio Alisio de Meneses Cordeiro

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.