Open-Source Enterprise IP PBX Management Portal & Unified Communications
Asterisk 22 · PHP 8 · MariaDB · WebRTC · Instant Messaging · Android & iOS Apps
📖 Documentation · 🌐 Website: aipbx.bid · 🖥️ Live demo · 📺 YouTube
🚀 Quick Install • 🔄 Updating • ✨ Features • 🛡️ Privacy & GDPR/KVKK • 📚 Documentation • 🏗️ Architecture • 📋 Changelog • 🗺️ Roadmap • 🤝 Contributing • 💖 Sponsor & Partners • ⚖️ Disclaimer
🖥️ Look around first: aipbx.bid/demo is the portal itself with a made-up company (English, Türkçe, Deutsch): every page, live call figures, nothing to install. Changes are not saved there.
# Recommended one-liner installation (installs the latest release)
curl -fsSL aipbx.bid/i | sudo bashOr via direct GitHub raw URL:
# Alternative direct GitHub script
curl -fsSL https://raw.githubusercontent.com/mahirgul/AiPBX/main/install.sh | sudo bashOr clone manually and install the latest release:
git clone https://github.com/mahirgul/AiPBX.git /opt/aipbx
cd /opt/aipbx
git checkout "$(git tag -l 'v*' --sort=-v:refname | head -1)"
sudo bash install.shThe installer:
- 🌐 Asks for your FQDN — with Let's Encrypt if DNS points to the server, otherwise a self-signed
certificate; leave it blank for a LAN-only install announced as
aipbx.localvia mDNS - 🔑 Generates strong random secrets for every service (no default passwords)
- ⚙️ Installs and configures Asterisk, MariaDB, Nginx + Apache, PHP, coturn, the Go chat service, firewalld and fail2ban, and builds the database from migrations
- 📄 Prints the credentials and saves them to
/root/aipbx-credentials.txt
💡 Requirements: 64-bit OS (Ubuntu 26.04 LTS+, Debian 13+, Raspberry Pi OS 64-bit, or Armbian) · x86_64 or aarch64/arm64 · 2 GB RAM · 10 GB disk · root access
☁️ Cloud Server: Deploy on UpCloud (fast MaxIOPS storage) with $250 free cloud credits using promo code
affiliate-aipbx250.🛠️ Developers:
AIPBX_REF=maininstalls the current development branch instead of the latest release.
After installing, open https://<your-server> and log in with the admin credentials shown.
Narrated and with subtitles — on the AiPBX YouTube channel:
| English | Türkçe | Deutsch |
|---|---|---|
![]() |
![]() |
![]() |
| English | Türkçe | Deutsch |
|---|---|---|
![]() |
![]() |
![]() |
Releases are published as git tags (vX.Y.Z) with notes in CHANGELOG.md.
sudo aipbx-update --check # installed vs. latest release
sudo aipbx-update # update to the latest releaseOr from the portal: System → System Update (admin only) shows the installed and latest version, the release notes and an Update button with live progress. A new release is also checked for every night.
Every update:
- 📞 restarts Asterisk only when the release needs it (new Asterisk configuration or package); otherwise Asterisk is reloaded and calls stay up. The update page says which beforehand; when a restart is needed you choose to wait for the calls to end or to end them;
- 🛡️ keeps files edited by hand (they go into the backup), unless the release changes the same file;
- 💾 backs up the database,
/etc/ai-pbx.envand/etc/asteriskto/var/backups/aipbx/; - 🔄 applies database migrations, new packages and system settings without touching passwords, certificates, the admin password or your firewall choices;
- ✅ verifies the services and the portal — and rolls back automatically (code, database and settings) if anything fails; then tests every page in the background and reports a problem on the System Update page.
Keep customisations out of /opt/aipbx (use the portal, /etc/ai-pbx.env and *_custom.conf
files) so they survive updates. Installations older than 1.50.0 go through the 1.50.0 bridge
release first; aipbx-update does both steps in one run. See INSTALL.md for details.
- Extension management — PJSIP-based, one number on desk phone, browser and mobile at once (SIP + WebRTC + mobile endpoints)
- Calling permission groups (call barring) — prefix and exact-match rules (
0,05,00), per-extension assignment, default allow-all - Voicemail — Asterisk voicemail with unconditional / busy / no-answer / unavailable triggers,
managed in My Phone or with feature codes (
*97own mailbox,*98mailbox login), in-browser player; message limits and PIN rules (minimum length, not the extension number, random PIN for new mailboxes) - Boss – secretary groups — executive interception, simultaneous or sequential secretary ringing, VIP whitelist bypass, automatic failover
- Ring groups — virtual numbers mixing extensions and external numbers, simultaneous or sequential
- Conference rooms — ConfBridge with PINs, wait-for-leader, join muted and live web moderation (mute/kick)
- Trunks — IP or registration based, tabbed settings, copy, rename and drag-and-drop ordering;
inbound DID trimming, transit routing between PBXes and carriers, per-trunk outbound caller ID
normalization (keep last N digits + prefix, e.g. extension
7840→903704187840), per-trunk dialled number format (strip / add a prefix), DTMF mode, session timers, 100rel and T.38 options; limits for concurrent channels (inbound + outbound) and calls per minute stop loops and toll fraud - Outbound routes — Asterisk patterns, strip/prepend, trunk failover chain, route groups for PBXes with different number formats, copy and ordering, duplicate patterns rejected
- Inbound and outbound call normalization — per-device rules (desk phone, mobile app, browser) turn what users dial
(
+90…,000…) into one format before the outbound routes, per-trunk rules do the same for incoming numbers; ready-made rules per country loaded on request, simulators, and a guide to the order of all number settings - DID routing, time conditions, multi-level IVR — optional menu repeat when no key is pressed, and IVR data steps: look up the entered digits or the caller's number in an external database or over HTTP and route on found / not found / timeout (docs)
- Queues — dynamic agent login/logout, static agents, hold music, recording, position and periodic announcements that can be switched off or tuned
- Spoken status instead of tones — "The person at extension 3001 is on the phone" in the caller's language, played before answering so trunk calls are not billed
- PBX tuning — jitter buffer, SIP timers, a 10-minute SIP debug switch, log rotation and a night restart window used only when an update replaced libraries and no call is up (docs)
- Troubleshooting menu — SIP traffic (
.pcapcapture files fromaipbx-signaling, Call-ID dialog list, interactive SVG call-flow ladder diagram, and Live SIP stream), Problem recording (aipbx-diag: one-click masked diagnostic.zipwith SIP logs, CDRs, queue events and PBX state), live Registrations (desk phones, browsers, mobile apps and trunks with RTT), Call quality (RTCP packet loss & jitter) and Phone logs (docs) - Feature codes —
*81/*80queue login/logout,*72call forward,*60DND,*43intercom,*90/*91/*92spy/whisper/barge,*97/*98voicemail - In-band disconnect supervision — disconnect-tone detection for analog/legacy trunks
- Safe apply — generated configuration is reloaded atomically; a failed write or Asterisk reload is rolled back and the change stays pending
- Live dashboard — active calls and channels, callers waiting in queues, today's answered / missed calls and per-trunk channel usage, refreshed every 5 seconds
- Complete Turkish prompt set in one voice — every Asterisk core prompt plus voicemail, digits,
conference, queue and directory prompts, so Turkish calls never switch to English halfway. Shipped
as
asterisk-core-sounds-trpackages in six formats (wav, ulaw, alaw, gsm and HD g722/sln16), so Asterisk plays the file matching the call's codec — and any Asterisk server can use them - Call recordings — converted automatically to mono 16 kbps MP3 (~8× smaller than WAV), played in CDR reports, My Phone and the apps
- Local Network Phone Discovery (
/phones) — automated discovery daemon (aipbx-phone-discovery) monitors local subnets, DHCP lease files, ARP cache, anddnsmasqlogs every 5 minutes; new devices appear instantly in the Discovered on the network panel - Zero-Touch Pool Provisioning — automatically allocates extensions from an administrator-configured pool (
provision_discovery_pool) and maps detected OUI vendors to default models (provision_discovery_models), producing TFTP/HTTP configuration files without manual entry - Multi-Vendor Provisioning Engine — automated configuration generation for Yealink (T3x, T4x, T5x), Fanvil (X series), Grandstream (GXP, GRP), Snom, Gigaset, and Cisco (SPA series and CallManager enterprise series)
- Cisco 7900 & 8800 CallManager Series — native
SEP<MAC>.cnf.xmlXML profile generation, XML directory services, and line keys across 11 enterprise models (cisco-cm-7941gthrough7975g,8841,8851,8861); see docs/cisco-callmanager.md - Phone regions — groups of phones get their own SIP server, port, transport, proxy, NTP, syslog, codecs, time zone and language (Provisioning → Regions), e.g. one set inside the network and one outside
- SIP over TLS on port 443 (v1.71+) — for desk phones on networks that let TLS out only on 443: the same 443 port serves the portal, TURN and these phones. nginx tells them apart by the region's own SIP server name (
sip1.example.combeside the portal's name) or, without one, by the phones' addresses; Asterisk accepts the name and Let's Encrypt puts it on the one certificate. One switch on the region; see docs/phones.md - Automated SCCP-to-SIP Firmware Switching — model-by-model firmware migration pipeline that moves Cisco 7900 phones from proprietary SCCP to Cisco SIP firmware upon restart, with server-side
.loadsmanifest validation before deployment - Phonebook and LDAP directory for desk phones (v1.77.1+) — shared company contacts (Provisioning → Phonebook, CSV import) served with the extensions over a read-only LDAP phonebook (389 StartTLS / 636 LDAPS): phones search by name and show the caller's name; the
ldap-syncplugin brings people from Active Directory or OpenLDAP; see docs/phonebook.md - Yealink OpenVPN package (v1.77.2+) — one-click
.tardownload (vpn.cnf+keys/) on Network → VPN Server for Yealink phones to upload under Network → Advanced → VPN (docs)
- Inbound/outbound fax — T.38 and G.711 (res_fax + SpanDSP)
- Compose in the browser (rich-text editor) or upload a PDF; resend failed faxes
- E-mail notification with the fax attached; per-DID recipients
- Agent desk and wallboard — live queues, waiting callers (with pickup), agent states (idle / ringing / in call / on break), SLA, answered / missed / abandoned statistics
- Breaks with reasons, applied in Asterisk per queue, and break reports
- Manual queue callbacks — callers press 1 while waiting, hear a confirmation and hang up; assigned agents call from a shared list. Answered agent conversations clear the request, including when the customer calls again; unanswered attempts stay pending.
- Listen, whisper and barge — from the wallboard or with
*90/*91/*92 - Call transfer that keeps the caller connected through queue Local channels
- Queue Report Centre — service level, answered / lost calls, average wait and talk time per queue and per agent, lost calls with call-back tracking, repeat callers and call outcomes
- Call reports and call journey — calls grouped by linkedid with a step-by-step timeline; caller, inbound and outbound trunk, dialled number and direction (inbound / outbound / internal / trunk to trunk, transferred), recording playback with a waveform player
- Branded PDF and Excel export for every report, as filtered, with all rows
- Browser phone built into the portal header — no installation
- TURNS (coturn) relay for clients behind NAT and strict firewalls — clients use 443, which the nginx multiplexer hands to coturn (5349); per-user, time-limited credentials refreshed automatically
- NAT handled in the generator — public/private address mapping for ICE and every SIP transport; see WebRTC, NAT and TURN
- Opus + DTLS-SRTP encrypted audio
- Selective Forwarding Unit (SFU) Architecture — Built directly on Asterisk 22
app_confbridge(video_mode=sfu). RTP video streams are forwarded without CPU-intensive server-side transcoding, enabling modern browsers to render high-definition responsive gallery grids with multiple simultaneous participants. - Hardware SIP Video Phone Compatibility (Follow-Talker) —
video_mode=follow_talkerautomatically switches the dominant active speaker's video stream to standard hardware SIP video phones (Yealink, Grandstream, Snom) that support only single video streams. - Meeting Scheduler (
/meetings) — Schedule planned or recurring conferences with start/end times, topics, participant limits, and PIN protection. - Public Guest Magic Links (
/meet/{token}) — Allows external clients, vendors, and non-subscribers to join video conferences directly from any modern browser with zero registration and zero app installation. - Pre-Join Lobby & WebRTC In-Browser Room — Pre-flight camera/mic hardware checks, responsive auto-resizing video tiles (1 to 9+ participants), in-call screen sharing (
getDisplayMedia), and audio/video toggles. - Calendar & Invitations — Branded email invitations with one-click join links and downloadable RFC 5545
.icscalendar files.
- 1-to-1 and group chat (Go WebSocket service
aipbx-chat), group admins, member management - Photos and files with thumbnails; access limited to the conversation's participants
- Presence, typing indicators, read receipts; push notifications on mobile
- Group voice and video calls from the chat (v1.77+) — a call button in a group opens a conference for its members only; the others join from the chat card, on the web and in the Android app; video follows the speaker
- SMS / MMS on your numbers (community plugin, v1.71+) — Twilio, Vonage, Plivo, Telnyx, Bandwidth, Sinch or VoIP.ms; the users a number is given read and answer its messages under Messages (
smsin the plugin catalog)
- Android (Kotlin) — AiPBX-Android: WebRTC calling with push wake-up and a foreground service, chat, directory with presence, call history, DND / call forward, in-app log viewer. Available on Google Play.
- iOS (SwiftUI, CallKit) — AiPBX-ios: calling with native incoming-call screen, chat, directory, features.
- Sign-in with username + password (+ 2FA code), by scanning a QR code on the portal, or with the one-time link in the invitation e-mail
- Same version as the server — the Android app of release 1.50.1 is 1.50.1 too
- Cloud TTS — turn text into speech with Google (API key or service account), Amazon Polly, Azure AI Speech, ElevenLabs or OpenAI; listen, download the MP3 or save it as an announcement in one click. Credentials are stored encrypted; usage is tracked per character
- Dialplan Editor (
/assistant) & Echo Reporter — plain-language PBX change planner with dry-run preview before apply, safety validation, audit trail and one-click undo (pbx_ai_changes), plus the Echo diagnostic box backed by an opt-in local HEPv3 SIP signaling capture daemon (aipbx-signaling→pbx_signaling_events)
- Direct Routing over SIP-TLS 5061 with SRTP
- User ↔ extension mapping (Microsoft 365 UPN, E.164)
- Teams channel notifications (missed calls, voicemail, queue alarms, faxes)
- Generated PowerShell setup scripts from your PBX configuration
- Stateless REST API (
/api/v1/*) & OpenAPI 3.1 — 100+ endpoints covering extensions, trunks, inbound/outbound routes, queues, ring groups, IVRs, time conditions, conferences, dial permissions, call center, CDRs, recordings, voicemails, faxes, phones, sounds, AI, chat, system settings, and sync - Scoped Bearer API Keys (
apbx_...) — per-token granular scopes (extensions:read,calls:write,system:read, …), IPv4/IPv6 CIDR allowlists, and per-minute sliding-window rate limits (/api-keys) - Outbound Webhooks (
/webhooks) — real-time event subscriptions (call.started,call.answered,call.ended,voicemail.received,fax.received,sync.applied, …) withX-AiPBX-Signature(HMAC-SHA256), exponential retry worker (aipbx-webhook-worker), and DNS-pinned SSRF protection - First-Class Plugin System (
/plugins) — zero-bloat modular integrations (google-auth,ms-teams,web-widgets,ai-cloud,ai-tts,ai-apps,ai-models), dedicatedplg_*MySQL table sandbox (schema.sql), custom.zipplugin uploader, encrypted secret storage, pages for signed-in users as well as administrators (user_page, v1.71+), and Safe Mode circuit breaker (auto-disables any plugin after 5 consecutive runtime errors) - Signed community catalog — opt-in plugin install/update with Ed25519 catalog verification (1.74+) and package checksums; Auto Dialer, AI Assistant and AI Voicemail are maintained in the separate plugin repository.
- Auto Dialer & AMD Campaigns (
auto-dialer) — automated outbound calling campaigns with Asterisk Answering Machine Detection (AMD()), global & per-campaign AMD tuning, queue free-agent pacing, voicemail drop (WaitForSilence), and CSV call outcome export
- 100% Opt-In by Default (
Off / Custom) — zero rules enforced unless explicitly enabled by an administrator under Security → GDPR & Data Privacy (KVKK ve Veri Gizliliği in Turkish); see docs/privacy.md - One-Click Regulatory Presets — instant templates for KVKK (Turkey Law No. 6698 & BTK), EU / UK GDPR, US CCPA / Two-Party & FCC (47 CFR § 64.1200), HIPAA (Healthcare PHI), PCI-DSS v4.0, and LGPD / PIPEDA / POPIA / PDPA
- Inbound Pre-Call Disclosure & Consent — play a custom disclosure prompt (
notice), allow DTMF Opt-Out (Press 9 for unrecorded call→ sets__PRIVACY_NO_RECORD=1across DID routes, Queues & Ring Groups and tagsCDR(accountcode)=PRIVACY_OPTOUT), or enforce Explicit Consent Opt-In (Press 1 to allow recording) - FCC Periodic Recording Beep — configurable
MixMonitor(...,B(15))periodic beep interval (5–60 seconds) during recorded calls - PCI-DSS & Live AGI/AI PII Redaction — automatic Luhn-validated payment card (13–19 digits), CVV, and National ID (
REDACTED-CARD/REDACTED-ID) masking on live AGI/AI transcripts and voicemail transcriptions before storage or external LLM calls - Automated Nightly Retention Purge (
privacy_purge.php) — independent retention windows (in days) for call recordings, voicemails + transcripts, faxes, chat messages, and dual-DB CDRs (asteriskcdr+cdrsanonymized asREDACTEDso call volume statistics remain intact) - Subject Access Request (SAR) & Right to Erasure — search any phone number or extension across dual CDR tables, recordings, voicemails, faxes, and SIP signaling events; download a portable SAR JSON Data Package (
PRIVACY_SAR_EXPORT) or execute irreversible Right to Erasure (PRIVACY_ERASURE) with an immutable Audit Log certificate - Cross-Border Cloud AI Lock — single toggle that blocks all outbound Cloud AI / STT / LLM calls (
CloudAiService::configured() === false) so audio and transcripts never leave the local PBX server
- Scheduled tasks (off by default, administrators only) — shell, PHP or Python scripts on a cron schedule, run in a systemd sandbox as an unprivileged user (never root, never the web server), with run history, Run now and alerts on failure (docs)
- External database connections — MySQL/MariaDB and PostgreSQL, password stored encrypted; every session read-only with a 2.5 s statement limit, used by IVR data steps (docs)
- Two-factor authentication (TOTP) with offline QR codes and single-use recovery codes — enforced for portal, mobile and Google sign-in
- Passkeys (WebAuthn / FIDO2) — passwordless sign-in with biometrics or PIN
- Google sign-in (optional) with token audience and verified e-mail checks
- Sessions revoked on password change — mobile and chat tokens stop working immediately
- User invitations — generated passwords, forced first-login change, mobile sign-in link
- RBAC — built-in roles (admin, viewer, queue manager, agent, fax, user — the default) and custom roles with per-module permissions; security-critical pages are admin-only
- Brute-force protection — math CAPTCHA, account/IP lockout and a fail2ban jail using the real client address (PROXY protocol from the 443 edge)
- Certificates page — one certificate for portal, TURNS and SIP-TLS: Let's Encrypt (tested on staging first, renewed automatically), upload PEM or PFX/P12, or self-signed; problems that silently break WebRTC (self-signed, wrong name, missing chain) are flagged
- Night dialling protection — at night and at weekends, calls to protected prefixes (
00,0900…) are blocked or need a PIN, transit calls included - Failed registration alarm — too many failed SIP logins alarm in the bell and by e-mail
- Nightly backups — database, configuration, and uploaded plugins (
aipbx-backup, 14 days, optional off-server copy) - Firewall and fail2ban management from the portal through a single, argument-validated root
helper (
aipbx-priv) — the portal never runs arbitrary commands as root - Hardening — CSRF tokens, security headers, sandboxed uploaded files, Asterisk HTTP on loopback, Apache kept in Ubuntu's systemd sandbox with only the paths the portal needs opened
- 23 interface languages including Turkish 🇹🇷 and English 🇬🇧 (6,300+ keys per language; a text not yet translated shows in English)
- Universal Live Filtering & Pagination across all multi-record tables (extensions, trunks, routes, system users, audit log, call reports) and responsive mobile drawer/table layout
AiPBX/
├── web/ # 🌐 PHP MVC portal & REST API v1
│ ├── src/
│ │ ├── core/ # Router, PluginManager, ApiRequestContext, ResourceNormalizer
│ │ ├── controllers/ # Page controllers + ApiV1Controller (+ api/ sub-handlers)
│ │ ├── services/ # Business logic, PrivacyService, DialplanService, ApiTokenService, WebhookService
│ │ ├── repositories/ # Database repositories
│ │ └── sync/ # Asterisk configuration generators
│ ├── templates/ # Layouts + views (including /privacy, /api-keys, /webhooks, /plugins)
│ ├── api/ # Portal JSON endpoints + /api/v1/* rewrite
│ ├── lang/ # 23 interface languages
│ ├── db/migrations/ # Phinx migrations (the database schema)
│ └── tests/ # PHPUnit
├── plugins/ # 🔌 Bundled plugins: official (auto-dialer, ms-teams, web-widgets, ai-*, …) and community
├── ai/ # 🤖 Local & cloud AI service (aipbx-ai, Python)
├── chat/ # 💬 Go WebSocket chat service (aipbx-chat)
├── signaling/ # 📡 HEPv3 SIP/RTCP signaling & .pcap capture daemon (aipbx-signaling, Python)
├── conf/ # ⚙️ Configuration & services
│ ├── asterisk/ # ☎️ Asterisk base configuration
│ ├── sbin/ # 🔐 aipbx-priv (root helper), aipbx-update (updater)
│ └── systemd/ # 🔄 systemd unit templates
├── integrations/wordpress/ # 🧩 WordPress click-to-call & callback plugin
├── sounds/ # 🔊 bundled custom sounds + Turkish prompt texts (core-sounds-tr.txt)
├── asterisk-core-sounds-tr-*.tar.xz # 🇹🇷 Turkish prompts, one package per format (+ SHA256SUMS)
├── docs/ # 📚 administrator & developer documentation
├── db/seed.sql # 🗄️ initial roles, permissions, settings
├── scripts/release.sh # 🚀 publishes a release
├── install.sh # 🛠️ installer (--upgrade mode used by aipbx-update)
├── VERSION · CHANGELOG.md
└── README.md · INSTALL.md · ARCHITECTURE.md
| Layer | Technology |
|---|---|
| ☎️ PBX | Asterisk 22 (PJSIP, res_fax, AMD, AMI, ODBC) |
| 🌐 Web | PHP 8, MVC, Composer; vanilla JS + CSS |
| 🗄️ Database | MariaDB (Phinx migrations + plg_* plugin sandbox) |
| 🛡️ Edge | nginx stream on 443 (ALPN, SNI + PROXY protocol) → Apache, coturn (TURNS) or Asterisk (SIP-TLS of phone regions) |
| 💬 Chat | Go + gorilla/websocket |
| 🎧 WebRTC | coturn TURN/STUN, DTLS-SRTP, Opus |
| 🤖 Android | Kotlin, WebRTC, FCM (AiPBX-Android) |
| 🍎 iOS | Swift, SwiftUI, CallKit (AiPBX-ios) |
| ⚙️ CI | GitHub Actions: PHPStan, PHPUnit, page smoke tests, Go tests |
- 🔑 Credentials are in
/root/aipbx-credentials.txt— note them and delete the file. - 🔒 Service secrets live in
/etc/ai-pbx.env. - 📜 To switch a self-signed install to a Let's Encrypt or your own certificate, use Security → Certificates — see docs/certificates.md.
- 🔥 Ports and updating: INSTALL.md.
- ✉️ Set an e-mail relay (fax-to-e-mail, voicemail, invitations): docs/mail.md.
- 📖 Configuring trunks, routes, roles and more: documentation.
AiPBX follows a transparent, phased engineering roadmap. For the complete specification, architectural diagrams, and upcoming milestones, see ROADMAP.md (or online at aipbx.bid/docs/roadmap).
- ✅ Wave 1 (Delivered in v1.50.10): Trunk rate limits, early media announcements, night dialing protection, voicemail PIN policies.
- ✅ Wave 2 (Delivered in v1.50.11): Sandboxed scheduled background tasks (
systemd-run), encrypted external database integrations, IVR caller lookup steps, PBX fine-tuning & Asterisk night restarts. - 🚀 Wave 3 (In Active Development & Planning):
- Several customers on one server: one Incus/LXD container per customer running the normal install, managed from a super-admin page. One AiPBX in a container works today.
- Remote GPU Speech Engines: Offloaded high-fidelity neural TTS engines on dedicated GPU compute instances.
Contributions are welcome — see CONTRIBUTING.md for code style, commit conventions and testing.
- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feat/my-feature) - 💾 Commit your changes (
git commit -m 'feat: add awesome feature') - 🚀 Push the branch and open a Pull Request
Code comments, commit messages and documentation are written in English.
ℹ️ Independent project: This is a personal, independent open-source pet project developed entirely in my private spare time and is not affiliated with, endorsed by, or related to my employer.
⚠️ English — Disclaimer of Warranty & Regulatory Responsibility
- Provided "AS IS": AiPBX is open-source software provided under the MIT License "AS IS", without warranty of any kind, express or implied. In no event shall the author or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, without limitation, service interruptions, data loss, or toll fraud) arising out of the use or inability to use this software.
- Call Recording, AI Processing & Automated Outbound Dialing Compliance: Features such as call recording, AI speech-to-text / LLM processing, and automated outbound dialing (
auto-dialer/ AMD) are subject to strict telecommunications, wiretapping, and data protection laws worldwide (including GDPR, KVKK, FCC / TCPA, CCPA, HIPAA, and local two-party consent statutes). Configuring appropriate pre-call disclosures, obtaining caller/callee consent, and complying with local laws are the sole responsibility of the system administrator and deploying organization.- Emergency Calls (
112/911/E911): VoIP and IP PBX telephony depend on electrical power, network connectivity, and properly configured upstream SIP trunks. AiPBX is not a certified replacement for traditional PSTN emergency lines unless explicitly configured, tested, and maintained with a compliant carrier by the operator.- Network Security & Toll Fraud: While AiPBX generates strong random credentials and configures firewall/fail2ban rules by default, securing SIP trunks, outbound dial permissions, rate limits, and network exposure against unauthorized access or toll fraud remains the sole responsibility of the system administrator.
⚠️ Türkçe — Sorumluluk Reddi ve Yasal Uyarı
- "Olduğu Gibi" (AS-IS) Sunum: AiPBX, MIT Lisansı kapsamında açık kaynaklı olarak, açık veya zımni hiçbir garanti verilmeksizin "OLDUĞU GİBİ" sunulmaktadır. Yazılımın kullanımından veya kullanılamamasından doğabilecek doğrudan ya da dolaylı hiçbir zarardan (hizmet kesintisi, veri kaybı, yetkisiz arama/fatura maliyeti vb. dahil) geliştirici veya katkıda bulunanlar sorumlu tutulamaz.
- Çağrı Kaydı, Yapay Zeka ve Otomatik Arama Mevzuat Uyumu: Çağrı ses kaydı, yapay zeka ile ses-metin dönüştürme (STT/LLM) ve otomatik dış arama (
auto-dialer/ AMD) özellikleri; 6698 sayılı KVKK, BTK düzenlemeleri, İYS / Ticari Elektronik İleti mevzuatı, GDPR ve ilgili ülkelerin telekomünikasyon/dinleme yasalarına tabidir. Aydınlatma metinlerinin dinletilmesi, açık rıza alınması ve yasal saklama sürelerine uyum tamamen sistemi kuran ve işleten kurumun/yöneticinin sorumluluğundadır.- Acil Çağrı Hizmetleri (
112/911): VoIP ve IP santral üzerinden yapılan aramalar elektrik enerjisi, yerel ağ, internet erişimi ve SIP operatör (trunk) bağlantısına bağımlıdır. Uygun operatör yönlendirmesi ve yedeklilik sağlanmadığı sürece geleneksel sabit acil çağrı hatlarının (PSTN) yerini garanti etmez.- Ağ Güvenliği ve Ücretli Arama Güvenliği (Toll Fraud): Kurulum aracı rastgele güçlü parolalar ve güvenlik duvarı kuralları oluştursa da; SIP trunk limitlerinin, dış arama yetkilerinin (Call Barring) ve sunucu erişim güvenliğinin korunması sistem yöneticisinin sorumluluğundadır.
If you find AiPBX useful for your organization or projects, consider sponsoring its ongoing development and maintenance:
AiPBX runs great on UpCloud high-performance European and global cloud servers with ultra-fast MaxIOPS block storage.
Sign up via our affiliate link to claim $250 in free cloud credits:
- Affiliate Link: signup.upcloud.com (with $250 credit)
- Promo Code:
affiliate-aipbx250
Mahir Gül · mhrgl.com · LinkedIn · @mahirgul
This is a personal, independent open-source pet project developed entirely in my private spare time and is not affiliated with, endorsed by, or related to my employer.










