Open Source Video Conferencing and Streaming Server


Quick start installation guide for OpenVCX Video Conferencing Server.  Read more


Basic Startup Configuration

Quick start configuration guide for OpenVCX Video Conferencing Server.


SIP Video Client Configuration Checklist

A guide for configuring SIP Video VoIP calling client for use with OpenVCX Video Conferencing Server.  Read more


Using WebRTC

A guide for configuring and using WebRTC with OpenVCX Video Conferencing Server.  Read more


Basic Startup Configuration for OpenVCX Video Conferencing Server


Once you have OpenVCX up and running you will need to create one or more conference definition files to allow SIP calling clients to make use of the server.

A conference definition file is a text properties file used to create a virtual conference SIP URI. The unique SIP URI can be dialed by a SIP calling client to connect to the configured conference. Conference definition files exist in the directory:


Conference definition files can be created and removed during server runtime, which can be done by an external provisioning application.

OpenVCX comes out of the box with a sample conference definition file VCX_INSTALL_DIR/conferences/1234.conference. A SIP calling client can dial the SIP uri to connect to this conference. The domain part of the URI can be anything.

The conference definition defines conference behavior and settings:

  • Permitted conference participants.
  • Conference SIP password.
  • Maximum number of participants.
  • Conference recording.
  • Secure media policy.
  • Conference video encoder resource usage.

The example conference definition defines several video codec specific encoder configurations. The configuratinos are defined by using the encoder= property. OpenVCX will search for the appropriate encoder profile which is a best fit for the advertised video capabilities of the connecting client.


OpenVCX uses the configuration file VCX_INSTALL_DIR/conf/sip-conference.conf. This file is used to define server behavior and settings:

  • UDP/RTP port range
  • SIP settings
  • OpenVSX (Video Streaming Processor) properties
  • Offered video and audio codec configurations


OpenVCX runs in the context of the Mobicents SIP Server JSLEE 1.1 (JSR 240) Application Server Sip Servlets framework available either for JBoss or Apache Tomcat. This example uses Tomcat as the servlets container.

Servlet socket listener properties are defined in the file VCX_INSTALL_DIR/conf/server.xml. These settings are used to define the server SIP listener ports, such as UDP/TCP, SSL, and Websockets.


OpenVCX produces log output in VCX_INSTALL_DIR/logs/sip-conference.log.

Each conference is serviced by a dedicated OpenVSX (Video Streaming Processor) process which handles all media traffic. OpenVSX creates a conference specific log file in the directory VSX_HOME/log/.

For eg., VSX_HOME/log/log_1234mydomain.com_Mon-Jan-01-13:54:41.log.







Don't hesitate to contact us via our contact page or email us at