Browsed by
Category: F.A.Q

Frequently asked questions

Run miniSipServer on Ubuntu

Run miniSipServer on Ubuntu

2011-12-26 updated:

Please visit following blog for latest message:


Since miniSipServer V4.0 is released, it is very easy to deploy VOIP server on Ubuntu now.

The difference between MSS V4.0 (windows) and MSS V4.0 (Linux) is that MSS (linux) doesn’t provide GUI management. It only provide web management. It is still very easy to setup and manage the VOIP network.

First, please download xxx.tar.gz file from our website. In following section, we give example on how to use miniSipServer V4.0 (20 client) :

It is a zip package file, once you have download it, please use following command to unzip it.

tar zxvf mss_v4_u20_i386.tar.gz

After that, you can find a “” file in the directory. Please run it to install MSS. During the process, some 3rd parties software, such as libmysqlclient, will be installed automatically from Ubuntu software center.


Then, you can run miniSipServer now:

sudo msscli

When the MSS is running, you can find following information in the command window:

HTTP server is running at port 8080

It means MSS has started HTTP server at TCP port 8080, you can  visit it now to manage your SIP server by using firefox, chrome, IE,etc. For example, you can open local firefox and type following address to visit it:


We have to mention here the default administrator password is blank. So once you login into the web management, the first thing you need do is to set administrator password. Please click “basic configuration / system configuration” to do that.

So easy, right? If you have any questions, please fell free to contact us. We hope you can enjoy it!

sip trunk

sip trunk

In VOIP depolyment, “SIP trunk” is often used to establish a connection with peer sip servers or gateways. For example, in most DID services deployments, SIP trunk is required to send or receive DID calls.

The difference between “SIP trunk” and “External lines” is that SIP trunk doesn’t require authorization during the call. That means, “external line” is server-to-users mode and “SIP trunk” is a server-to-server mode.

It is very easy to establish SIP trunk in MSS.

For example, we want to establish SIP trunk with peer server whose domain name is “” and its SIP port is 5060 which is a default SIP UDP port.

step 1: add the server into MSS servers list

Please click menu “data / peer servers” and add a new record with following information:

peer server id=1
description = demo sip server
server address =
server port  = 5060

step 2: process incoming call

Once we receive incoming calls from peer servers, we want to route them to local users. We can use “dial plan” to do that.

For example, we want the DID incoming calls whose called numbers prefix is “1234” to local users, such as 1234100 to local user 100, 1234101 to local user 101, etc.

Please click menu “dial plan / transition” to configure a number transition:

transition ID = 1
transition type = delete
start position = 0
length = 4

Please click menu “dial plan / analysis called number” to configure a record to route DID numbers to local users:

dial plan = default
called number prefix = 1234
route type = local user
change called number = yes
transition id = 1

step 3: process outgoing call

We want our outgoing calls to be routed to such peer SIP server/gateway. We still need configure “dial plan” to do that.

For example, we want all calls whose called number prefix is “00” should be routed to such SIP server, such as “008613800138000”, etc.

Please click menu “dial plan / analysis called number” to add a new record with following information:

dial plan = default
called number prefix = 00
route type = SIP trunk
peer server ID = 1


How to upgrade miniSipServer?

How to upgrade miniSipServer?

In different scenario, this question can be different. In fact, this question can be seperated to several questions:

Q1: What we need do when we upgrade MSS?

The most important thing is backup your previous configuration files.If there is any exception during the upgrade, we can roll-back to previous version.

All miniSipServer configuration files are stored in the ‘config’ sub-directory where MSS is installed.So it is very easy to backup the system, what we need do is just copy this sub-directory to anywhere your want.

We can uninstall previous version and install the new version in the same directory.Because the configuration files are kept in the ‘config’ directory, the new version will detect, use and upgrade previous configuration files automatically.

Q2: I am using V2.9, can I upgrade to V2.10 or above?

Yes, of course. By default, it is free to upgrade MSS from low version to higher version since they can share the same license. So just download the latest version and enjoy it.

Q3: I am using 20 clients version, can I upgrade to 50 clients and how?

Since different licenses are used, you need pay the price differentials between these version. Please visit our ‘buy now‘ page to get details.

Once you get the new license, you can uninstall previous version and install new version, then input new license to enable it. The upgrade process is almost same with above description.

Can miniSipServer run on Linux system?

Can miniSipServer run on Linux system?

2011-12-26 updated:

WINE is unnecessary for latest miniSipServer! Please visit following blog for new message:


Linux system becomes more and more popular now, and more and more customers send mail to us to ask whether miniSipServer can run on linux system, specially Ubuntu system.

As we know, miniSipServer is a SIP server designed for Windows system. Since Linux is quite different with Windows, we cannot install and run miniSipServer on Linux directly at current stage. In future, we maybe release native miniSipServer for Ubuntu. (In fact, miniSipServer V4.0 or above can run on Ubuntu without WINE, please refer to following document:

But now we can run miniSipServer on Ubuntu or other linux systems with “Wine” software. Thanks to “Wine” develop teams’ great work, most windows softwares can run on linux system, including miniSipServer.

The Wine mode is “Linux sysem <–> Wine <–> Windows software”. Please refer to its official websire for more details.

After download and install “Wine” software, it is almost same for us to install and run miniSipServer which we have done on the Windows platform. What we need do is doublt-click the .exe file and install it! Very easy.

Let’s give a simple example on how to install wine and miniSipServer on Ubuntu system:

Step 1: install Wine

In the terminal window, please type the command: sudo apt-get install wine

Step 2: install miniSipServer

Download the latest miniSipServer install file to our Ubuntu system. Double-click the .exe file to install it.

Step 3: run miniSipServer

In the Wine menu, we can see miniSipServer shotcut icon. Just click the icon to run it.

Easy, right? why not try it now? 🙂