# siremis

**Repository Path**: okhelper/siremis

## Basic Information

- **Project Name**: siremis
- **Description**: https://github.com/asipto/siremis/
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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](https://github.com/asipto/siremis-php)

Project web site:

* [https://www.siremis.org](https://www.siremis.org)

## Overview

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

* [https://www.kamailio.org](https://www.kamailio.org)

Some screenshots can be seen at:

* [https://github.com/asipto/siremis/issues/1](https://github.com/asipto/siremis/issues/1)

## Usage

### Download Binary

Download the archive with the binary release from:

* [https://github.com/asipto/siremis/releases](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](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/](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