Documentation

Everything you need to run Voiplix

Self-hosted VoIP billing and PBX. Set up a provider, price your calls, route them, connect a phone — and see the first call and its charge, start to finish.

Start here: Quick Start

A fresh install has no traffic yet. This walks you through the eight steps that get you a working, billed phone call — about 20 minutes, real screens from the product.

Open the Quick Start
  1. 1First login
  2. 2Add a provider
  3. 3Set up tariffs & rates
  4. 4Configure routing (LCR)
  5. 5Create a user
  6. 6Create a device
  7. 7Configure a phone
  8. 8Make the first call

What is Voiplix

Voiplix is a self-hosted VoIP billing and PBX system: one Asterisk-based platform that handles call routing, rating and invoicing in one place.

It manages your providers (who you buy and sell minutes through), tariffs and rates (what a call costs and what you charge for it), least-cost routing (which provider carries a given call), your customers and their devices, and the calls, balances and invoices that follow. It is built for operators running their own billing and telephony — not a hosted SaaS dashboard.

Explore the wiki

Step-by-step guides with real screens from the product.

Getting started

The Quick Start — provider to first call, in order.

Users & Customers

The users list, roles, creating and editing a user, balances, resellers and the customer portal.

Devices & PBX

Devices, call handling, voicemail, and the PBX layer: ring groups, queues, IVR menus and PBX pools.

More PBX features

The rest of the PBX menu: phonebook, BLF groups, music on hold, IVR voices/sound files/time periods, PBX functions, External DIDs, Cloud PBX, Quickforward rules and the browser softphone.

Tariffs, Providers & Routing

Buy and sell tariffs, rates and destinations, importing rate sheets, currencies, provider configuration, and least-cost routing.

Advanced routing

Number pools for CID rotation, cause-based failover, localization and reusable device rule groups.

DIDs & Inbound

Phone numbers: the DID list and its statuses, creating and assigning numbers, inbound routing and callflows, DID rates and number pools.

Billing & Invoices

Prepaid vs. postpaid, payments and gateways, invoices and the invoice run, credit notes, recurring services, and currencies.

SMS

Sending text messages through an SMS provider, priced and billed the same way as a call.

Resellers

The operator's Reseller menu, what a reseller sees signed in, its own users/tariffs/providers/routing, and billing between operator and reseller.

Reports & Statistics

Watch calls live and make sense of them afterwards: dashboard, calls, CDR, recordings and statistics.

Monitoring & Alerts

Fraud scoring, listening in on live calls, alerts and where they go, scheduled jobs, servers and packet capture.

Administration & API

Settings, staff accounts and permissions, branding, backups and the REST/XML API.

API reference

Every /api/<method> endpoint, grouped, with parameters, hash order and example requests and responses.

Installation & updates

Server requirements, the installer, first setup, license activation, and how updates work from the web interface.

Guide for end customers

The customer portal, page by page, written for the customer: overview, calls, invoices, payments, numbers, devices, prices, recordings, voicemail, quickforwards, SMS and their own details.

Troubleshooting & FAQ

A phone won't register, a call fails, there's no audio, a customer can't call, a provider is down — where to look, in order.

Release notes

What changed in each version, newest first.