PHPackages                             mikopbx/core - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps &amp; Deployment](/categories/devops)
4. /
5. mikopbx/core

ActiveApplication[DevOps &amp; Deployment](/categories/devops)

mikopbx/core
============

Free PBX system for SMB based on Asterisk

2024.1.114(2y ago)5271.4k77[19 issues](https://github.com/mikopbx/Core/issues)GPL-3.0-or-laterPHPPHP ^7.4CI passing

Since Nov 24Pushed 1mo ago14 watchersCompare

[ Source](https://github.com/mikopbx/Core)[ Packagist](https://packagist.org/packages/mikopbx/core)[ Docs](https://www.mikopbx.com)[ Patreon](https://www.patreon.com/mikopbx)[ RSS](/packages/mikopbx-core/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (20)Versions (21)Used By (0)

[![Translation status](https://camo.githubusercontent.com/35d8a6c724e151321b5e70a97c64709bdee514b6660e4eb8c78161852cec4840/68747470733a2f2f7765626c6174652e6d696b6f7062782e636f6d2f776964676574732f6d696b6f7062782f2d2f61646d696e2d7765622d696e746572666163652f7376672d62616467652e737667)](https://weblate.mikopbx.com/engage/mikopbx/)[![GitHub All Releases](https://camo.githubusercontent.com/c126dd03fa5f31314330f8c364c4bf3242f3d48fea4b449501d73194b0039520/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f6d696b6f7062782f636f72652f746f74616c)](https://github.com/mikopbx/Core/releases)[![Latest Release](https://camo.githubusercontent.com/4f5b677711aa8e3278dbb54de715a42be40629b7ecb4e7d4fca2eec9f73a96e1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6d696b6f7062782f636f72653f636f6c6f723d626c7565)](https://github.com/mikopbx/Core/releases/latest)[![GitHub last commit (branch)](https://camo.githubusercontent.com/d9c30001b2dc71e5220c5c95c047a96c38c169e7a90fed9fd763b514d040988d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d696b6f7062782f636f72652f646576656c6f703f6c6162656c3d6c617374253230636f6d6d69742532306f6e253230646576656c6f70)](https://github.com/mikopbx/Core/tree/develop)[![Code Quality](https://camo.githubusercontent.com/f236e0e404dc8c62aa4d975effcb8d5541216b0db6cd83646ce9ecff728d0f8e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d696b6f7062782f636f72652f636f64652d7175616c6974792e796d6c3f6272616e63683d646576656c6f70266c6162656c3d636f64652532307175616c697479)](https://github.com/mikopbx/Core/actions/workflows/code-quality.yml)[![GitHub](https://camo.githubusercontent.com/211072cb031c31602e943f633408830ad978cc2aa7686c3a8c3e49c750d0d58a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d696b6f7062782f636f7265)](https://camo.githubusercontent.com/211072cb031c31602e943f633408830ad978cc2aa7686c3a8c3e49c750d0d58a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d696b6f7062782f636f7265)

MikoPBX — Free Phone System for Small Business
==============================================

[](#mikopbx--free-phone-system-for-small-business)

```

88b           d88  88  88                     88888888ba   88888888ba  8b        d8
888b         d888  ""  88                     88      "8b  88      "8b  Y8,    ,8P
88`8b       d8'88      88                     88      ,8P  88      ,8P   `8b  d8'
88 `8b     d8' 88  88  88   ,d8   ,adPPYba,   88aaaaaa8P'  88aaaaaa8P'     Y88P
88  `8b   d8'  88  88  88 ,a8"   a8"     "8a  88""""""'    88""""""8b,     d88b
88   `8b d8'   88  88  8888[     8b       d8  88           88      `8b   ,8P  Y8,
88    `888'    88  88  88`"Yba,  "8a,   ,a8"  88           88      a8P  d8'    `8b
88     `8'     88  88  88   `Y8a  `"YbbdP"'   88           88888888P"  8P        Y8

```

> [🇷🇺 Русская версия](README.ru.md)

What's MikoPBX?
---------------

[](#whats-mikopbx)

MikoPBX is an open-source PBX system with a modern web interface for managing [Asterisk](https://www.asterisk.org/). It ships as a compact Linux distribution with all necessary services pre-configured — Asterisk, Nginx, PHP-FPM, Redis, Fail2Ban, and more. You can write any module you can think of and distribute it to your users through the built-in marketplace.

Install MikoPBX on premise, in a virtual machine, in a Docker or LXC container, or on any major cloud provider (AWS, Google Cloud, Azure, etc.)

 [ ![](https://github.com/mikopbx/assets/raw/master/img/screenshots/ExtensionsList.png) ](https://www.mikopbx.com)

The system has an easy and convenient web interface with call recording, conference calls, voicemail, call transfers and pickup, call queues, IVR menus, inbound and outbound call rules, holidays and night-time call switcher, custom call-flow programming, and a marketplace with paid and free extensions. All core business functionality is free forever!

- English [website](https://www.mikopbx.com)
- Russian [website](https://www.mikopbx.ru)

Getting Started
---------------

[](#getting-started)

### Installation Methods

[](#installation-methods)

MikoPBX can be deployed in multiple ways depending on your environment:

#### Standalone / Bare Metal

[](#standalone--bare-metal)

- [Live USB installation](https://docs.mikopbx.com/mikopbx/english/setup/bare-metal/live-usb)
- [Bootable USB installation](https://docs.mikopbx.com/mikopbx/english/setup/bare-metal/bootable-usb)

#### Virtual Machine

[](#virtual-machine)

Download the [latest ISO](https://github.com/mikopbx/Core/releases/latest) and boot from it in your hypervisor:

HypervisorGuideVMware ESXi[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/vmware-esxi)VMware Workstation Pro[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/vmware-workstation-pro)VMware Fusion (Mac)[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/vmware-fusion)VirtualBox[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/virtualbox)Hyper-V[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/hyper-v)Proxmox (VM)[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/proxmox)Proxmox (LXC container)[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/proxmox/lxc)UTM (Apple Silicon)[Installation guide](https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/utm)#### Docker Container

[](#docker-container)

- [Docker installation prerequisites](https://docs.mikopbx.com/mikopbx/english/setup/docker/docker-installation)
- [Running MikoPBX in a container](https://docs.mikopbx.com/mikopbx/english/setup/docker/running-mikopbx-in-container)
- [Running MikoPBX with Docker Compose](https://docs.mikopbx.com/mikopbx/english/setup/docker/running-mikopbx-using-docker-compose)

#### Cloud Providers

[](#cloud-providers)

ProviderGuideAWS EC2[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/aws/aws-deployment-guide) • [AWS Marketplace](https://docs.mikopbx.com/mikopbx/english/setup/cloud/aws/aws-marketplace)Google Cloud[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/google-cloud/google-cloud) • [GCP Marketplace](https://docs.mikopbx.com/mikopbx/english/setup/cloud/google-cloud/google-cloud-marketplace)Microsoft Azure[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/microsoft-azure)DigitalOcean[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/digitalocean)Vultr[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/vultr)Alibaba Cloud[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/alibaba-cloud)Hetzner Cloud[Deployment guide](https://docs.mikopbx.com/mikopbx/english/setup/cloud/hetzner-cloud)### First Steps After Installation

[](#first-steps-after-installation)

Open the web interface and log in with default credentials — username: `admin`, password: `admin`. Then follow the [Quick Start guide](https://docs.mikopbx.com/mikopbx/english/readme/quick-start) to configure your system.

Features
--------

[](#features)

- Compact Linux distribution — boots in seconds.
- Easy to install, easy to set up.
- Multilingual interface (26 languages) with community translation via [Weblate](https://weblate.mikopbx.com).
- x86\_64 and ARM64 architectures.
- Latest PJSIP stack and Asterisk 22 LTS.
- Dual-stack IPv4/IPv6 networking.
- Fail2Ban, iptables firewall, WebAuthn/Passkey authentication.
- Modular architecture with a plugins marketplace.
- PHP 8.4, [Phalcon Framework](https://phalcon.io), Nginx, Redis.
- REST API with 259+ endpoints and JWT authentication.
- Cloud auto-provisioning (AWS, GCP, Azure, DigitalOcean, Vultr, Yandex Cloud, VK Cloud, Alibaba Cloud).
- Modern codebase written according to PSR standards and Airbnb JS style.

Requirements
------------

[](#requirements)

Concurrent CallsCPURAMStorage5–101 GHz x86-64 or ARM64, 1–2 cores2 GB1 GB system + 50 GB recordingsUp to 253 GHz x86-64 or ARM642 GB1 GB system + 50 GB recordings25+Dual CPU 3 GHz x86-644 GB+1 GB system + 50 GB recordingsSee the full [system requirements](https://docs.mikopbx.com/mikopbx/english/readme/system-requirements).

How to Modify Your System
-------------------------

[](#how-to-modify-your-system)

For easy customisations, use the dialplan application editor. It supports PHP-AGI or Asterisk Dialplan language.

 [![](https://github.com/mikopbx/assets/raw/master/img/screenshots/ApplicationEditor.png)](https://github.com/mikopbx/assets/raw/master/img/screenshots/ApplicationEditor.png)

Or use direct system file customisation on the web interface.

 [![](https://github.com/mikopbx/assets/raw/master/img/screenshots/SystemFileCustomization.png)](https://github.com/mikopbx/assets/raw/master/img/screenshots/SystemFileCustomization.png)

MikoPBX usually loads from a read-only *offload* partition. If you want to change something in the core, remount the partition to write mode with the SSH command: `remount-offload`

If you want to add new functionality, we strongly advise you look at the [ModuleTemplate](https://github.com/mikopbx/ModuleTemplate) repository.

Architecture
------------

[](#architecture)

MikoPBX is a self-contained Linux distribution built on [T2 SDE](https://t2sde.org/). Key components:

ComponentVersionPurpose**Asterisk**22PBX engine with PJSIP stack**PHP**8.4Application runtime**Phalcon**5High-performance PHP framework**Nginx**1.29Web server with WebSocket support (nchan)**Redis**7Cache, sessions, and API queue**Beanstalkd**1.12Background job processing**Fail2Ban**1Intrusion prevention**SQLite**—Main database and CDR storage### Source Structure

[](#source-structure)

```
src/
├── AdminCabinet/     # Web UI (MVC + Volt templates + Semantic UI)
├── Common/           # Models, translations, DI providers
├── Core/             # Asterisk configs, system utilities, workers
├── Modules/          # Module framework
├── PBXCoreREST/      # REST API (49 controllers, 259+ endpoints)
└── Service/          # Service layer

```

Interface and Documentation Translation
---------------------------------------

[](#interface-and-documentation-translation)

The web interface has been translated into 26 languages with the help of our community:

 [![](https://github.com/mikopbx/assets/raw/master/img/screenshots/LanguageSettings2.png)](https://github.com/mikopbx/assets/raw/master/img/screenshots/LanguageSettings2.png)

If you find any mistakes, you are welcome to fix them on the [Weblate](https://weblate.mikopbx.com) translation service.

Contributing
------------

[](#contributing)

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

Community &amp; Support
-----------------------

[](#community--support)

- **Forum**: [forum.mikopbx.com](https://forum.mikopbx.com) — questions, discussions, community help
- **Telegram**: [Developer Chat](https://t.me/mikopbx_dev) — real-time community chat
- **Bug Reports**: [GitHub Issues](https://github.com/mikopbx/Core/issues)
- **Documentation**: [docs.mikopbx.com](https://docs.mikopbx.com)
- **Paid Support**: [Professional support](https://www.mikopbx.com/support/) from MIKO LLC

Sponsors
--------

[](#sponsors)

Become a sponsor and get your logo on our README on GitHub with a link to your site. [Become a sponsor](https://patreon.com/mikopbx)

License
-------

[](#license)

MikoPBX© — free phone system for small business Copyright © 2017–2026 Alexey Portnov and Nikolay Beketov

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see .

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance58

Moderate activity, may be stable

Popularity38

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 62% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~97 days

Recently: every ~165 days

Total

14

Last Release

734d ago

Major Versions

2020.3.94 → 2021.1.542021-02-01

2021.4.175 → 2022.1.992022-04-17

2022.3.15 → 2023.1.2232023-04-18

2023.2.206 → 2024.1.1142024-05-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/3bfc9b4ea0dd15c5117a5a1ae5a5ef256133ba2b5fa088556e6c3d2a56245d35?d=identicon)[jorikfon](/maintainers/jorikfon)

---

Top Contributors

[![jorikfon](https://avatars.githubusercontent.com/u/5922918?v=4)](https://github.com/jorikfon "jorikfon (2902 commits)")[![boffart](https://avatars.githubusercontent.com/u/5922739?v=4)](https://github.com/boffart "boffart (1340 commits)")[![weblate](https://avatars.githubusercontent.com/u/1607653?v=4)](https://github.com/weblate "weblate (415 commits)")[![miko-service-bot](https://avatars.githubusercontent.com/u/214372907?v=4)](https://github.com/miko-service-bot "miko-service-bot (10 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (6 commits)")[![mzhelka](https://avatars.githubusercontent.com/u/126671155?v=4)](https://github.com/mzhelka "mzhelka (2 commits)")[![gao385573958](https://avatars.githubusercontent.com/u/91579801?v=4)](https://github.com/gao385573958 "gao385573958 (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

arm64asteriskasterisk-pbxcloudcommunicationsdockerhacktoberfestlxcopen-sourcepbxphalconphppjsiprest-apiself-hostedsipsip-servertelephonyvoipvoip-serverphalconasteriskvoiptelephonysippbxucFreePBXmikopbx

### Embed Badge

![Health badge](/badges/mikopbx-core/health.svg)

```
[![Health](https://phpackages.com/badges/mikopbx-core/health.svg)](https://phpackages.com/packages/mikopbx-core)
```

###  Alternatives

[marcelog/pami

Asterisk Manager Interface (AMI) client for PHP, event driven, object oriented

415750.6k1](/packages/marcelog-pami)[marcelog/pagi

Asterisk Gateway Interface (AGI) client for PHP, suitable to make telephony applications using call flow nodes

192133.7k16](/packages/marcelog-pagi)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35636.1k2](/packages/telnyx-telnyx-php)[chan-sccp/pami

Asterisk Manager Interface (AMI) client for PHP, event driven, object oriented (Fork)

2952.3k](/packages/chan-sccp-pami)[wormling/phparia

Asterisk REST Interface (ARI) client for PHP.

419.8k](/packages/wormling-phparia)[rtckit/sip

SIP protocol implementation written in PHP

4417.4k2](/packages/rtckit-sip)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
