Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
February 3, 2017 00:29
April 18, 2021 12:24

Unix setup | Windows setup | macOS setup | MonaTiny | Docker | Documentation | About


Temporary project planned to replace MonaServer.

MonaServer is a lightweight web and media server customizable by LUA script applications. MonaServer supports currently following protocols:

  • HTTP(TLS) with a rendez-vous extension (cmd RDV) to meet peers together (e.g. SDP exchange for WebRTC)
  • WebSocket(TLS)
  • STUN
  • RTMP(E)
  • SRT
  • RTP, RTSP (in progress...)

MonaServer supports advanced features for the following media containers:

  • MP4
  • FLV, F4V
  • TS
  • HLS
  • ADTS, AAC, MP3
  • SubRip, VTT
  • Mona

Start MonaServer developments by reading the documentation

Unix setup


  • g++ version >=5 (or compliant clang...)
  • OpenSSL libraries with headers, usually dev-package named libssl-dev or openssl-devel
  • LuaJIT library with headers, dev-package named libluajit-5.1-dev or prefer luajit 2.1 beta by building from sources:
git clone
cd LuaJIT
make && sudo make install


Download or clone MonaServer sources and compile everything simply with make:

git clone
cd MonaServer2

To enable SRT Protocol define ENABLE_SRT variable



Start executable :

cd MonaServer

Windows setup


A Windows 32-bit and a Windows 64-bit zipped packages are provided to test MonaServer. However we recommend to build the github version from the sources for production use.


./External/lib>dir                 ./External/lib>dir
    srt/srt.h                                   pthread_lib.lib
    srt/logging_api.h                           pthread_libd.lib
    srt/platform_sys.h                          srt_static.lib
    srt/srt4udt.h                               srt_staticd.lib

Note: OpenSSL and LuaJIT dependencies are already included in the project.


Download or clone MonaServer sources, open Mona.sln project file with Visual Studio, right clic on MonaServer project and clic on Build.


Start MonaServer by selecting MonaServer project and pressing F5.

macOS setup


  • XCode version >=8 and Xcode dev Tools which you can install using the following command :
xcode-select --install
  • OpenSSL libraries with headers. The most simple way to install them is to use Homebrew:

First, install homebrew :

/usr/bin/ruby -e "$(curl -fsSL"

Then install openssl :

brew install openssl
  • LuaJIT library with headers :
brew install luajit

Or prefer luajit 2.1 beta by building from sources :

git clone
cd LuaJIT
make MACOSX_DEPLOYMENT_TARGET=10.14 && sudo make install

Note: Mac-OSX target require a MACOSX_DEPLOYMENT_TARGET definition with make MACOSX_DEPLOYMENT_TARGET=10.X where (10.X is your macOS version), see this LuaJIT issue for more details.

brew install srt

Build & Start

See Unix setup Build and Start chapters


MonaTiny is a version of MonaServer without LUA script applications. Setup is identical excepting that there is no LuaJIT dependency, just start executable file ./MonaTiny/MonaTiny


A Docker image is available on Docker Hub with the name monaserver/monaserver. See more at

To run monaserver in Docker use the following command :

docker run --rm -it --name=mona -p 80:80 -p 443:443 -p 1935:1935 -p 1935:1935/udp monaserver/monaserver



Asks your questions or feedbacks relating MonaServer usage on the MonaServer forum.

For all issues with MonaServer please create an issue on the github issues page.

MonaServer is licensed under the GNU General Public License and mainly powered by Haivision, for any commercial questions or licence please contact us at contact_mail.