SIREMIS - Web Management Interface Fo Kamailio

This is the next-generation SIREMIS written in Go language.

The old SIREMIS generation written in PHP (with support up to PHP 7.x) can be found at:

• https://github.com/asipto/siremis-php

Project web site:

• https://www.siremis.org

Overview

SIREMIS is a generic web management interface designed to work mainly with Kamailio SIP Server:

• https://www.kamailio.org

Some screenshots can be seen at:

• #1

Usage

Download Binary

Download the archive with the binary release from:

• https://github.com/asipto/siremis/releases

Untar or unzip the archive.

Download Sources

Clone the repository:

git clone https://github.com/asipto/siremis

Build the application:

cd siremis
go build .

Kamailio Database Setup

It is required that Kamailio is installed and its database is created. For now Siremis supports only MySQL/MariaDB database type. If you want to have accounting and statistics, the corresponding tables have to be created -- the SQL statements can be taken from:

• docs/database.md

Alternatively, kamcli can be used to create the tables and store procedures.

Run Siremis

Copy etc/config-sample.json to etc/config.json. Edit etc/config.json and update database access and authentication users.

Copy etc/siremis-menu-sample.json to etc/siremis-menu.json, and etc/siremis-charts-sample.json to etc/siremis-charts.json.

Run the application:

./siremis

Go with a modern web browser to:

• http://local.ip:8284/siremis/

Replace local.ip with 127.0.0.1, or your local IP address, or the domain name if you have set up a DNS entry for it.

See siremis -h for options to set the IP and port to listen on, or the domain and certificates for HTTPS.

The application can be run on a different folder, not only from the source tree, in such case the directories etc/, public/, schemas/ and templates/ have to be copied over, or pointed to them via configuration file.

DB Table Schema

The schemas/ folder contains the description of database tables, each on in a JSON file. New tables can be managed with Siremis by creating the corresponding JSON files.

Web Template

The templates/ folder contains the html templates. They can be changed to suit better own usage of Siremis. The template files are loaded and compiled at start up, any changes to them require a restart to become active.

Version Policy

The version string is composed of three numbers, the format is:

YY.MM.VV

Where:

• YY - the last two digits of the year for the release
• MM - the month of the release, if it is 0, then it is a development version
• VV - the incremental version for minor updates of the same release series

Contributions

Contributions can be made by submitting pull requests and have to be provided under BSD license.

License

License type: AGP v3.0

Copyright: 2025 Asipto.com