Onyx VoiceBusiness phone system
Version 0.2.16 · Preview

Your phone system. Your server.

Onyx Voice is a complete business phone system: extensions and auto attendants, call centre queues, desk phones that set themselves up, softphones for Windows and Android, and a live operations console that shows every call as it happens. Run it on your own hardware, or let us host it for you.

  • SIP & WebRTC
  • Many companies on one server
  • Encrypted calls
  • Installer ISO & VM images
The Onyx Voice operations console with made-up data: headline numbers for active calls, call cap, jitter, packet loss, phones and trunks; the calls in progress with extension, caller, address, codec and audio quality; server CPU and memory graphs; and a registration log.
Sets up desk phones from YealinkPolyGrandstreamCisco MPPFanvilSnomHtekCyberData
01Calls

Everything a business phone system does

The features people expect from a PBX, set up in plain language: say where a call should go, and Onyx builds the call plan for you.

Extensions & voicemail

A number and a phone for every person, voicemail with a PIN and greetings, and new messages sent by e-mail.

Auto attendants

"Press 1 for sales, 2 for support": menus with your own recordings and hold music, uploaded in any common audio format.

Business hours & holidays

Route calls one way during opening hours and another after hours, with holidays and an override from any phone.

Ring groups & paging

One number that rings a team, overhead paging groups and intercom.

Calls go where they should

Phone numbers, outbound routes with failover between carriers, caller ID rules and emergency numbers, set up from forms that explain themselves.

  • SIP trunks by registration or IP, with ready-made settings for common US SIP carriers: number format, caller ID and tech prefix.
  • Transfer, park and pickup, blind or attended, with parking lots per company.
  • Do not disturb and call forwarding, set with feature codes from the phone or in the user portal.
  • Conference rooms with PINs, a moderator, and live control: mute, remove, lock.
  • Hot desking: anyone signs in to a shared desk phone with their extension and voicemail PIN, and it rings for them.
  • Call recording per extension or queue, with retention per company and legal hold.
  • Contacts: an outside directory in every phone's phonebook, incoming callers named from it, synced from Active Directory, LDAP or Microsoft 365.
02Operations console

See every call as it happens

A console built for the people who keep the phones running: live numbers at the top, the calls in progress with their audio quality, the server's own health, and every company on the server at a glance.

Calls in progress with made-up data: each call's extension, caller ID, IP address, codec with a lock for encrypted calls, jitter and packet loss, and a running duration.
  • Live calls with the codec, the phone's address, jitter and packet loss, measured from the call's own audio reports.
  • Headline numbers: active calls against the call cap, average and worst jitter and loss, phones online, trunks up.
  • Server resources: CPU and memory of the server and of the call engine, the last 30 minutes.
  • Registration log: phones and trunks signing on and dropping off, and failed sign-ins.
  • Reports: calls per day and hour, busiest extensions and numbers, trunk usage, CSV exports.
  • Billing: rate plans by prefix and a monthly bill per company.
One health card per company, made up: a status light (online, degraded, down, switched off), calls now, phones and trunks, and bars for calls and media traffic over the last 24 hours.

Many companies, one server

Each company has its own numbers, phones, administrators and users. A system administrator sees them all.

Five looks

Slate Ops for the operations desk, plus Cut Obsidian, Swiss Precision, Tactical SOC and a light Daylight theme.

User portal

Voicemail, call history, call forwarding and do not disturb for every person, and a softphone in the browser.

03Call centre

Queues, a wallboard and supervisors

Built in, not an add-on: answer more calls, keep callers informed, and coach agents while they talk.

Queues

Ring strategies, agent priorities, wrap-up time, position and hold-time announcements, and overflow when a queue is full.

Wallboard

Callers waiting, the longest wait and every agent's state, refreshed every three seconds.

Listen, whisper, barge

Supervisors listen in, coach the agent without the caller hearing, or join the call.

Callback

Callers press 1 to hang up and keep their place; the next free agent is connected first, then the caller is called back.

Queue & agent reports

Answered, abandoned and waiting times per queue and per agent, with CSV export.

Switchboard

Receptionists see who is free, drag a call onto a person to transfer it, and pick up parked calls.

04Phones & apps

Plug in a phone. It sets itself up.

Desk phones at factory settings find the server on their own network, fetch their settings and register: extension, line keys, busy lamps, phonebook and time zone.

  • Plug and play: phones that ask the network for a server get an answer from Onyx; DHCP option 66 works too.
  • About 140 models from Yealink, Poly, Grandstream, Cisco MPP, Fanvil, Snom, Htek and CyberData, with a firmware library.
  • DECT: one extension per handset on Yealink, Snom and Gigaset bases.
  • Re-provision from the console: resync or restart a phone after a change.

Tested so far on Grandstream GXP2135 and GXP1625 desk phones. The other templates follow each maker's documentation and are being checked on real hardware.

In the browser

The user portal has a softphone: call, answer and transfer from any modern browser, with encrypted audio.

Windows

Onyx Softphone for Windows: a tray app with a dial pad, caller ID, missed calls and updates that install themselves.

Android

Onyx Softphone for Android, ringing like a normal call on the phone's own call screen.

iPhone

In development.

05Security

Built for a phone system on the internet

A phone system on the internet is a target. Onyx blocks the attackers and limits what a stolen password could cost.

Intrusion prevention

Addresses that keep guessing SIP or console passwords are blocked at the firewall, automatically.

Toll-fraud limits

International calling off by default, premium numbers blocked, and caps on calls at once, calls per hour and daily spend.

Encrypted calls

SIP over TLS and SRTP audio for phones and trunks that support it, with a free Let's Encrypt certificate.

Two-factor sign-in

Authenticator-app codes for administrators and users, recovery codes, and a switch that makes them required.

06Appliance

A whole phone server, not a list of prerequisites

Onyx Voice is its own small operating system, built on Ubuntu Server 24.04 LTS with PostgreSQL and the call engine included. Start it, answer a few questions on the console, and sign in to the console in your browser.

Install

Running in minutes

  1. Start the imageThe installer ISO for a physical server, a Hyper-V disk with a script that creates the VM, or an OVA for VMware.
  2. Answer the setupHost name, network, NAT, the firewall, an administrator and your first company.
  3. Plug in phonesPhones on the same network find the server by themselves.
Run

The server's own tools

  1. NetworkAddresses, DNS and the firewall. A change undoes itself unless you confirm it still works.
  2. StorageGrow the disk or add one for voicemail and recordings, from the browser.
  3. BackupsTo a Windows share, an NFS export or another disk, restored from the same page.
  4. DiagnosticsLogs, connectivity tests and a support bundle with passwords removed.
  5. Two serversA second server and a small witness take over within about half a minute when the first fails; phones stay registered.
  6. Move inBring extensions, ring groups, queues, menus, business hours and numbers over from FreePBX or 3CX.
.NET 10Asterisk 22 LTSPostgreSQL 16Ubuntu Server 24.04 LTSWebRTCArgon2idLet's Encrypt
07Yours or ours

Run it yourself, or have us run it

The same phone system either way. Choose where it lives.

On your servers

Self-hosted

Install the appliance on your own hardware or virtualization. Calls between your phones stay on your network, and you decide when to update.

Download
On ours

Hosted by Integrators Resource

We run the server, its updates and its backups. You manage your people, numbers and phones in the same console, and your phones register with us.

Talk to us
08Download

Get Onyx Voice

Version 0.2.16, a preview release.

Downloads ask for a user name and password. Ask us for access.

Physical or any VM

Installer ISO

Start a server or a virtual machine from it. It asks for the network and the disk, and needs no internet connection to install.

Download the ISO
  • File onyx-voice-0.2.16-installer.iso · 4.9 GB
Hyper-V

VHDX disk

A ready-made disk for a Generation 2 VM with Secure Boot. New-OnyxVM.ps1 creates and starts the VM.

  • File onyx-voice-0.2.16.vhdx · 5.2 GB
  • File New-OnyxVM.ps1 · 2 KB
VMware

OVA appliance

Deploy it in vSphere, or open it in Workstation or Fusion, choose the network and start it.

Download the OVA
  • File onyx-voice-0.2.16.ova · 1.8 GB
Ubuntu Server 24.04

Packages

For an existing Ubuntu Server 24.04 machine: install the engine package first, then Onyx Voice. The speech package adds the voices greetings are made in on the server.

  • File onyx-voice-engine_22.11.0-onyx1_amd64.deb · 174.0 MB
  • File onyx-voice_0.2.16+202611060140_amd64.deb · 103.4 MB
  • File onyx-voice-speech_0.2.16+202611060141_amd64.deb · 360.8 MB

2 CPU cores, 4 GB of memory and 40 GB of disk for a small office; more disk for call recordings. 64-bit x86. SHA-256 checksums

Softphones

For the people on the phone system. They sign in with their extension's details from the user portal.

Windows 10 (1809) and 11, 64-bit

Onyx Softphone for Windows 0.1.9

A tray app with a dial pad, caller ID and missed calls. It updates itself from our signed feed.

  • File OnyxSoftphone-0.1.9-windows-x64-setup.exe · 50.5 MB
  • File OnyxSoftphone-0.1.9-windows-x64.msi · 57.2 MB
Android 10 and later

Onyx Softphone for Android Coming soon

Rings on the phone's own call screen. Available soon.

APK
iPhone

Onyx Softphone for iPhone Coming soon

In development.

Previous versions

Older releases stay available, for a test lab or to match a server you already run.

0.2.15Preview2026-11-04

E-mail can now go out through Microsoft 365, Gmail or Google Workspace as well as your own mail server: voicemail, missed calls, reports, faxes and alerts, with step-by-step set-up in the console.

0.2.14Preview2026-10-28

A security fix: the first-boot web setup no longer writes the server account's password into the system log. The server's own screen has new full-screen menus, and the first-boot screen can set the server up right there instead of in a browser.

0.2.13Preview2026-10-24

Installing updates shows a progress bar, and the server checks for updates every 5 minutes. Inbound routes has its own place in the menu, under Outbound routes. The E-mail (SMTP) settings are one form that points out settings which cannot work together, and a failed test e-mail says what to change instead of showing an error dump.

0.2.12Preview2026-10-24

Give someone the Onyx Softphone without handing out a password: the console makes a one-time setup code, shown as a QR code and a link and e-mailed with the app downloads, and the app connects with it (Windows 0.1.9, Android 0.1.5). The Trunks page now says where each carrier's calls ring and lets you choose it there, and the dashboard's latest calls update as calls end.

0.2.11Preview2026-10-23

The call centre becomes an add-on, switched on per tenant (tenants that already have queues keep it). Live calls shows where each phone is: on the office network, outside, behind NAT, or behind a router whose SIP ALG rewrites its calls. The STUN service also answers over TCP, upgrades open its port on older firewalls, and the browser phone no longer waits for an unreachable STUN server. Grandstream phones keep their own tenant's provisioning address and get their firmware even at another tenant's address, and the console shows a phone's new firmware version straight after it upgrades.

No longer available for download. Install the current version instead.

0.2.10Preview2026-10-22

Fixes from the first production site. Phones now really receive the firmware you assign (Grandstream phones look for it next to their settings), and Desk phones shows which version each one runs. The Park key always parks in the company's own lot, and pressing it (or dialling 700) on an idle phone picks the parked call up. On GXP1628/1630 phones the Park key moves to the multi-purpose keys, where it stays during calls. Trunks show their real state straight after an update, and the call history updates itself.

No longer available for download. Install the current version instead.

0.2.9Preview2026-10-21

Call parking never drops a caller: a parked call nobody takes rings the person who parked it back, then goes to a destination you choose (their voicemail unless you pick another). The phone that parks a call gets a text message with the slot, and park slot keys now park a call as well as pick it up. Greetings made from text get a speed control and real pauses at commas. The server answers STUN requests itself (UDP 3478), so phones and apps can find their public address without an outside service.

No longer available for download. Install the current version instead.

0.2.8Preview2026-10-21

Moving from another phone system behind the same router: a new public address now takes effect at once (the engine restarts when no calls are up), and Broadvoice is in the carrier list. Let's Encrypt works for a server with a private host name and a public name under Also valid for. Status codes (*30 to *34) change the status even when the caller hangs up at once. Groundwork for push to the phone apps.

No longer available for download. Install the current version instead.

0.2.7Preview2026-10-21

Server account from the web console: on System & updates, set a new password for the server's onyxadmin account when nobody knows it, and add or remove the SSH keys that may sign in. Each change asks for your own web console password and is kept in the change history. Server settings: the mail group is now E-mail (SMTP), with a Send test e-mail button.

0.2.6Preview2026-10-21

Move a whole 3CX from its backup (one company per department, trunks, routes, voicemail). Status profiles (Available, Away, Lunch, Business trip) with forwarding per status, ring-mobile-too and office-hours following. Office hours on ring groups, queues and auto attendants, and break hours. Recording: outside calls only, *1 during a call, ring groups, a recording notice. Blocked callers, caller ID routing, *67, missed-call e-mail and health alerts. Queue intro and supervisor alerts, e-mailed call reports and what happened on each call. API keys, signed webhooks and a CRM lookup link; directory sync that gives people extensions. Fax boxes (faxes as PDF by e-mail, send PDFs) and text messages through Twilio or Telnyx in the portal.

0.2.5Preview2026-10-21

Setup in a web browser: after installing, the server's screen shows an address and a setup code, and the whole setup (host name, network, internet access, time zone, accounts, firewall, first company) runs in a step-by-step page with Back, a review before anything changes and live progress. A server without DHCP gets a static address from its screen with one key.

0.2.4Preview2026-10-20

Auto attendants: greetings made from text in natural voices on the server (cloud voices optional), the greeting written for you from the menu, and "Ask for a name": callers say who they want instead of pressing keys. Call parking: a console page, a Park key on desk phones that lights while a call waits, and parked callers hear your hold music. Every desk phone gets two line keys; Mitel 6800/6900 phones on SIP firmware. The dashboard is a board of tiles that fits the window, which each administrator can move, resize and hide. Flood protection limits what one address may send (SIP packets, connections, web requests) and blocks floods at the firewall. Callcentric and VoIP.ms trunks sign in correctly. Images rebuilt the same day: the first-boot setup asks for the host name instead of offering one it then refused.

0.2.3Preview2026-10-09

Updates: the server installs only what it needs (Onyx Voice and Ubuntu's security fixes), checks for updates by itself every day and says in the console when a new version is out. Ubuntu's automatic security updates no longer restart the phone engine or the database (which dropped calls, and on a cluster's active server started a failover); the console lists what to restart when it suits you, and they can be switched off.

0.2.2Preview2026-10-08

Voicemail to e-mail with a transcript made on the server (no cloud service) and the message attached as a small MP3, with per-extension choices (attach, notice only, off, delete once e-mailed); transcripts in the user portal. For the Onyx softphones: the parking lot, recording on demand, and a sign-in token per device with two-factor codes.

No longer available for download. Install the current version instead.

0.2.1Preview2026-10-08

Fixes for two-server clusters: installing updates no longer restarts the engine, the database or the network by itself (on the active server that could start a failover), the active server rides out a short database restart, and a planned switchover can no longer be cancelled half way. Clearer update messages.

No longer available for download. Install the current version instead.

0.2.0Preview2026-10-08

High availability (two servers and a witness: automatic failover with the phones' registrations), import from FreePBX and 3CX, the signed update repository switched on, unattended setup from a seed disk, and fixes.

No longer available for download. Install the current version instead.

0.1.0Preview

First release: phone system, call centre, desk phone provisioning, security and the appliance.

No longer available for download. Install the current version instead.

Source code

The call engine inside Onyx Voice is open-source software under the GNU General Public License, version 2. Its complete source, and how we build it, is here for anyone, without a password.

Call engine Asterisk 22.11.0, unmodified, with pjproject 2.17, as in every image and package on this page.

Speech helper onyx-speechd (the onyx-voice-speech package of Onyx Voice 0.2.16, GPL v3 or later) with sherpa-onnx 1.13.8 and the espeak-ng it builds in.

Written offer: for at least three years after we last distribute a release, Integrators Resource gives anyone who asks the complete corresponding source of the GPL software in it, including the Ubuntu packages in the images, for no more than our cost of providing it. Contact us, or write to Integrators Resource, 2210 4th Ave S, Minneapolis, MN 55404.

09Changelog

What changed in each release

Newest first. A server installs a new version from the web console, under System & updates.

0.2.16CurrentPreview2026-11-05
  • Call insights: recorded calls are transcribed with the two sides told apart, on the server (Whisper) or by an OpenAI-compatible service. With summaries on, a language model of your choice (OpenAI or compatible, Anthropic, or your own Ollama) adds a summary, a sentiment score, topics and follow-ups. Switched on per company under Tenants; set up under Server settings > AI.
  • Recordings shows each call's sentiment and summary, the transcript turn by turn, and finds calls by words said on them. Recordings > Call insights reports sentiment by person, direction and queue, with the most negative calls to look at. A call.transcribed webhook sends it all to a CRM.
  • Microsoft Teams Direct Routing (Connections > Microsoft Teams): Onyx Voice is the company's SBC. Calls to an extension also ring the person in Teams, and Teams users call colleagues and outside numbers as their extension. The page checks the certificate and DNS and gives the Teams PowerShell for the Microsoft 365 side.
  • Video meetings: a conference room with video on works in the browser at /meet/ with cameras, screen sharing and a people list; guest links let people outside the company join without signing in. Desk phones still join by dialling the room.
  • Chat & WhatsApp (Connections): a chat window for your website (one line of code) and WhatsApp through Meta's Cloud API or Twilio, answered by a team in the portal (Chat), with a chat report.
  • The server's Let's Encrypt certificate now has an RSA key (Microsoft Teams needs it; older desk phones prefer it). Microsoft 365 mail set-up points out an Object ID or Secret ID pasted in the wrong box.
0.2.15Preview2026-11-04
  • Server settings > E-mail has a new Send with choice: a mail server (as before), Microsoft 365, Gmail with an app password, or Google Workspace with a service account.
  • Microsoft 365 sends through Microsoft Graph with an app registration (permission Mail.Send), since Exchange Online no longer accepts a password over SMTP. Messages over 3 MB also need Mail.ReadWrite.
  • Google Workspace sends through the Gmail API as a mailbox of your domain, with a service account key and domain-wide delegation; no user's password is stored.
  • When sending fails, the console says what to change in one sentence (a Secret ID pasted instead of the secret's value, a missing permission, an unknown mailbox, the Gmail API turned off, and so on).
0.2.14Preview2026-10-28
  • Security fix: setting a server up in the web browser (0.2.5 to 0.2.13) wrote the onyxadmin password, and the join code of a second server, into the system log in plain text. They are hidden now. If you set up a server that way, change the onyxadmin password under System & updates > Server account after updating.
  • The server's own screen (menus, questions, the first-boot setup) uses new full-screen menus with the same look everywhere; they work over SSH and on the console alike.
  • On the first-boot screen, press T to set the server up right there instead of in a web browser.
0.2.13Preview2026-10-24
  • Install updates (and Check for updates) shows a progress bar with the step it is on: downloading, unpacking and setting up each package. The full output is under Show details; while Onyx Voice itself restarts, the page waits for it and carries on.
  • The server checks for updates every 5 minutes instead of once a day (it still installs nothing by itself); the Updates card and the menu's Update available line follow along. An install started during a check waits for it.
  • Inbound routes (the page that was Phone numbers (DIDs)) is its own menu item, right under Outbound routes.
  • E-mail (SMTP) is one form with one Save: Encryption is a list (STARTTLS, TLS from the start, None) and the port follows it; TLS on port 25, STARTTLS on 465 or a missing sender are pointed out as you type. An empty password keeps the saved one; an emptied field goes back to its default.
  • Send test e-mail saves the form first and keeps the answer on the page. A failure is one sentence saying what to change (for example "mail.example.com:25 does not start with TLS", a refused sign-in or sender) instead of an error dump. With no Mail sender, mail goes out as the username when it is an e-mail address.
0.2.12Preview2026-10-24
  • Onyx Softphone setup codes: Phone app on Sign-in accounts (and the extension's User portal card, and the person's own Sign-in and security) makes a one-time code with a QR code and a link; tick E-mail it and the person gets it with download links. It works once, for 7 days, without the password or a two-factor code. Also onyx user app-setup <email>.
  • The setup link opens a page on your server with the app download for that device and an Open in Onyx Softphone button; the apps (Windows 0.1.9, Android 0.1.5) also take the code under Use a setup code.
  • Trunks: an Incoming calls column and panel per trunk. Choose where every call on the trunk rings (an extension, ring group, queue, auto attendant, business hours or voicemail) and route numbers one by one; a new trunk asks right after it is added.
  • The dashboard's latest calls update as soon as a call ends (they loaded once before).
0.2.11Preview2026-10-23
  • Call centre add-on: queues, agents, the wallboard, queue callbacks and queue reports are switched on per tenant (Tenants, Call centre on). Tenants that already had queues keep them; without it no queue can be created.
  • Live calls shows where each registered phone is: office network, outside the office, behind NAT, or SIP ALG suspected (a router rewriting its calls, the usual cause of one-way audio); the log warns about SIP ALG.
  • STUN over TCP on port 3478, for devices on networks that block UDP.
  • Fixed: on servers set up before 0.2.9 the firewall had no STUN port, and calls from the browser phone and the apps waited for it. The update opens the port, and the browser phone stops waiting after 2 seconds.
  • Grandstream phones keep the provisioning address Onyx gave them, even on a network whose DHCP option 66 points at another tenant (setting DHCP may move set-up phones).
  • A phone at another tenant's provisioning address still gets its model's firmware there; the log says where it belongs.
  • Fixed: after a firmware upgrade, Live calls and Desk phones kept showing the old version until the server restarted.
0.2.10Preview2026-10-22
  • Fixed: phones never upgraded to the firmware assigned to their model. Grandstream phones given the server by DHCP option 66 ask for firmware next to their settings; Onyx now answers there too.
  • Desk phones shows the firmware each phone runs and whether the assigned version is still pending; the server log records every firmware download.
  • Fixed: the Park key parked outside callers in a lot the company's slot numbers could not reach. Calls are always parked in the company's own lot.
  • Simpler pickup: press the lit Park key, or dial 700, on an idle phone to pick up the parked call. **701 and the like pick up a slot.
  • GXP1628/1630: the Park key and other keys move to the multi-purpose keys, because the phone takes its line keys over during calls; all three line keys are the line.
  • Fixed: trunks showed Checking after an update until their state changed.
  • Call history updates itself every 15 seconds and says when a call could not be loaded.
0.2.9Preview2026-10-21
  • Call parking never drops a caller: a parked call nobody picks up rings the person who parked it back on all their phones (shown as “Park 701: caller”), then goes where you choose, their voicemail unless you pick another destination.
  • The phone that parks a call gets a text message with the slot: “Parked on 701: Jane Smith. Dial 701 to pick it up.”
  • Park slot keys park a call in their slot when pressed during a call, and pick it up when lit.
  • Call parking page: how long to ring the person back, where unanswered calls go, and the slot message.
  • Greetings made from text: a speed control (0.70× to 1.30×) and pauses at commas (short, long or very long), kept with each prompt.
  • Built-in STUN server (UDP 3478): softphones, the apps and the browser phone find their public address without an outside service.
  • Fixed: with a softphone or browser phone connected, stopping or updating the service took 30 seconds and ended with the service being killed; it now stops in a few seconds and the softphone reconnects.
0.2.8Preview2026-10-21
  • A new public address takes effect at once: the engine restarts by itself, when no calls are up, after any SIP transport change.
  • Broadvoice in the carrier list.
  • Let’s Encrypt works for a server with a private host name and a public name under Also valid for.
  • Fixed: status codes *30 to *34 change the status even when the caller hangs up straight away.
  • Groundwork for push notifications to the phone apps.
0.2.7Preview2026-10-21
  • Server account from the web console (System & updates): set a new password for the onyxadmin account, and add or remove the SSH keys that may sign in. Each change asks for your own console password and is kept in the change history.
  • Server settings: the mail group is now E-mail (SMTP), with a Send test e-mail button.
0.2.6Preview2026-10-21
  • Move a whole 3CX from its backup: one company per department, with trunks, routes and voicemail.
  • Status profiles (Available, Away, Lunch, Business trip) with forwarding per status, ring-mobile-too and following office hours.
  • Office hours and break hours on ring groups, queues and auto attendants.
  • Recording: outside calls only, *1 during a call, ring groups, and a recording notice for callers.
  • Blocked callers, caller ID routing, *67, missed-call e-mail and health alerts.
  • Queues: an intro message and supervisor alerts. E-mailed call reports, and what happened on each call.
  • API keys, signed webhooks and a CRM lookup link; directory sync that gives people extensions.
  • Fax boxes (faxes arrive as PDF by e-mail; send PDFs as faxes) and text messages through Twilio or Telnyx in the portal.
0.2.5Preview2026-10-21
  • Setup in a web browser: after installing, the server’s screen shows an address and a setup code. Host name, network, internet access, time zone, accounts, firewall and the first company are set in a step-by-step page, with Back, a review before anything changes, and live progress.
  • A server without DHCP gets a static address from its screen with one key.
0.2.4Preview2026-10-20
  • Auto attendants: greetings made from text in natural voices on the server (cloud voices optional), written for you from the menu.
  • “Ask for a name”: callers say who they want instead of pressing keys.
  • Call parking: a console page, a Park key on desk phones that lights while a call waits, and your hold music for parked callers.
  • Every desk phone gets two line keys; Mitel 6800 and 6900 phones on SIP firmware.
  • The dashboard is a board of tiles that fits the window; each administrator can move, resize and hide them.
  • Flood protection: limits on what one address may send (SIP packets, connections, web requests), with floods blocked at the firewall.
  • Fixed: Callcentric and VoIP.ms trunks sign in correctly.
  • Fixed (images rebuilt the same day): the first-boot setup asks for the host name instead of offering one it then refused.
0.2.3Preview2026-10-09
  • Updates install only what the server needs (Onyx Voice and Ubuntu’s security fixes); the server checks every day and the console says when a new version is out.
  • Ubuntu’s automatic security updates no longer restart the phone engine or the database. The console lists what to restart when it suits you, and they can be switched off.
0.2.2Preview2026-10-08
  • Voicemail to e-mail with a transcript made on the server (no cloud service) and the message attached as a small MP3, with choices per extension (attach, notice only, off, delete once e-mailed).
  • Voicemail transcripts in the user portal.
  • Onyx softphones: the parking lot, recording on demand, and a sign-in token per device with two-factor codes.
0.2.1Preview2026-10-08
  • Fixed (two-server clusters): installing updates no longer restarts the engine, the database or the network by itself, which could start a failover.
  • Fixed: the active server rides out a short database restart, and a planned switchover can no longer be cancelled half way.
  • Clearer update messages.
0.2.0Preview2026-10-08
  • High availability: two servers and a witness, with automatic failover that keeps the phones’ registrations.
  • Import from FreePBX and 3CX.
  • The signed update repository is switched on.
  • Unattended setup from a seed disk.
0.1.0Preview
  • First release: the phone system, call centre, desk phone provisioning, security and the appliance.
10Questions

Frequently asked

What is Onyx Voice built on?

On the open-source Asterisk 22 LTS call engine, which handles the calls themselves. Onyx installs it, writes all of its configuration and watches it; you never edit its files. Everything you work with, the console, the portal, the phone templates and the apps, is Onyx's own.

Where is the source code of the open-source parts?

The call engine is unmodified Asterisk with the pjproject library it bundles, both under the GNU GPL version 2. Their source and our build recipe are under Source code above, free to download. The images also contain Ubuntu Server packages, whose source is in Ubuntu's archive; we send any of it on request. The rest of Onyx Voice is our own software.

Which phones work with it?

Any standard SIP phone can register. Onyx sets up phones from Yealink, Poly, Grandstream, Cisco (MPP), Fanvil, Snom, Htek and CyberData by themselves. So far Grandstream GXP2135 and GXP1625 desk phones are tested; the other templates follow each maker's documentation and are being checked on real hardware.

Which phone carriers does it work with?

Any SIP trunk provider, with registration or by IP address. For common US providers the number format, caller ID and tech prefix are filled in for you.

Can it host several companies?

Yes. Each company on the server has its own extensions, numbers, phones, administrators and limits, and sees only its own calls. That is how we host it, and it works the same on your own server.

What do I need to run it?

A physical server or a virtual machine on Hyper-V, VMware or another hypervisor: 2 CPU cores, 4 GB of memory and 40 GB of disk for a small office, more disk if you record calls. A public address with the SIP and audio ports forwarded if phones or carriers connect from the internet.

How are updates delivered?

From our signed update repository at onyxvoice.net/apt: check and install them in the console (Server › System › Updates), together with Ubuntu's security fixes, or with apt upgrade. The server trusts our archive key for this repository only. A server without internet can switch the repository off and update from a new installer ISO.

Servers installed from 0.1.0 have it switched off. Turn it on once with sudo sed -i -e 's#^URIs:.*#URIs: https://onyxvoice.net/apt#' -e 's#^Enabled:.*#Enabled: yes#' /etc/apt/sources.list.d/onyx-voice.sources and they update from then on.

What happens when the server fails?

With two servers and a witness (a small third machine), the second server takes over within about half a minute: it has a live copy of the database, voicemail, recordings and prompts, takes the server's address and starts with the phones' registrations, so phones need not register again. Calls in progress at that moment drop. See High availability.

Can I move from FreePBX or 3CX?

Yes: upload a FreePBX database dump (or its Bulk Handler CSVs) or a 3CX user export, untick or renumber what you do not want, and Onyx Voice creates the extensions, ring groups, queues, IVRs, business hours and numbers. See Importing from FreePBX and 3CX.

Is it ready for production?

It is a preview. The features above work and are tested on our lab server with real calls, but it has not yet run a business's phones. Talk to us before relying on it.

What does hosting cost?

It depends on the number of extensions and numbers. Contact us and we will tell you.

Questions about your phones?

Tell us how many people, numbers and locations you have, and we will tell you how Onyx Voice fits.