BETA of 3CX for Linux

Get your hands on the BETA of 3CX PBX on Debian LinuxThe 3CX team is proud to announce a Linux version of 3CX! From now on, identical versions of 3CX are available either on Linux or on Windows. Our intention is for these versions to have feature parity and run the exact same technology.

The Linux version allows easier deployment to appliances and in the Cloud. Install 3CX on Debian 8 or alternatively you can run 3CX on any cloud that provides a Linux VPS. Here are two examples with 2 major providers:

Installing 3CX on Linux (Debian Linux 8)
Setting up 3CX on Google Cloud
Setting up 3CX on OVH

3CX for Linux runs initially only on Debian Linux. Our own ISO and other distributions will follow.

The following features are still in progress:

  • FAX
  • Call Reporting
  • Contact integration via Office 365
  • Failover

We look forward to receiving your feedback! Please post on our forum or as a comment below.

Liked this article?

Get notified of new articles
or share
You might also be interested in:
  1. Matt

    Is there a test/demo key?

    October 7, 2016 at 10:19 pm
    • Charalambos Eleftheriou

      @Matt, yes you can fill out the form from the link below and receive a free PBX Edition key:

      October 8, 2016 at 1:18 pm
  2. 3CX disrupting the sector once again. This is awesome.

    October 8, 2016 at 1:26 am
  3. Tried and true! I spun up an OVH VPS and the setup was good!

    October 9, 2016 at 12:36 am
  4. Did the .Net Core release for Linux make this possible?

    October 9, 2016 at 1:50 am
    • @Chris – yes for the .net components. The others were linux ready from before.

      October 9, 2016 at 1:34 pm
  5. Mark Dutton


    Look forward to seeing this as a packaged ISO when it goes GA.

    October 10, 2016 at 4:47 am
    • Soon!!! It will be a breeze to install..

      October 10, 2016 at 1:00 pm
  6. Mark Dutton

    Nicky I installed this and restored a backup to see if a Windows backup would work. It did and now I want to do it for real on the original Windows IP address. Uninstalling and reinstalling is not like Windows. The config remains. Do I simply run 3CXCleanup then 3CXWizard to start again?

    October 10, 2016 at 8:11 pm
  7. Awesome news. Looking forward to getting this deployed on Window-less, headless 1U appliances for customers.

    Nice job Team 3CX.

    October 11, 2016 at 5:07 am
  8. Rigardt

    when this is in GA will it run on a raspberry ?

    October 11, 2016 at 9:16 am
    • @Rigardt – not going to happen. And what pbx do you want to run on this? a 2 user pbx?

      October 11, 2016 at 9:29 am
  9. Rigardt

    @Nicky – was looking at running the free 8 user on a cheap box

    October 11, 2016 at 9:42 am
    • I’m afraid you might need to spend an extra 30-50 bucks and buy a mini pc. With a RPI it is not going to happen. This is a Fully fledged pbx. Appreciate that the needs for 3CX are not the same as a simple notepad application. Get a mini pc with a celeron processor that costs like 80 bucks (30 bucks more expensive than that of a RPI with an enclosure).
      You can find with windows or debian. I mean now that we released 3CX on debian, we really have no excuses to save costs.
      Also .net core is not even available for noobs. So 3cx on RPI is not going to happen anyways. RPI is good to be an SBC.

      October 11, 2016 at 10:03 am
  10. Rigardt

    a mini pc would have been ideal but alas not available in our country. importing makes very expensive. thanks in any way

    October 11, 2016 at 10:12 am
    • Asus for example. Check more. You will find.
      Maybe you should be better off not having a box at all and getting a VPS hosted instance for 2 bucks. a month. That’s 24 bucks a year. You can spend 4 years with this setup for the same price of a mini PC!!! :) And it is on a professional hosted infrastructure… Think like this.

      October 11, 2016 at 10:16 am
  11. This is seriously such good news. Hopefully we head more in this direction in the future

    October 11, 2016 at 5:12 pm
  12. Are there any plans to script the AWS installation in the same way you have for Google Cloud?

    October 12, 2016 at 3:50 pm
    • We did this but we did not release it. I can give you one if you want – but I’m sure you will not like the result..
      Keeping the machine constant, a machine that cost 7 dollars on google, and 5.99 on ovh come up to 75 dollars/month on amazon!!!!!! .. tried it myself.. I was shocked at how expensive it was and quickly removed the script from repository…

      October 12, 2016 at 3:56 pm
  13. I jumped into the Linux/debian version to get rid of Windows Heavyness. Great job, all is ok and works perfectly. Except that I still have ramdon 500 internal server error. How can I get rid of this ? I thought it was Something related to Windows but…
    Anyway, great job !

    October 13, 2016 at 12:06 pm
    • @Guillaume – Can we see these 500 server errors pls.. We have many fixed in the upcoming SP2 of windows (*which will also generate a new linux build couple of days after release)
      If you can put your findings in the forum we can check and add fixes.. We want to eliminate them all.. Thanks

      October 13, 2016 at 12:09 pm
  14. Oleg Gilev

    Alleluia! It finally happened! We’ve been waiting for it longer than Darth Vader waited for Obi Wan! Hope virtual appliance will come soon too.

    October 13, 2016 at 3:18 pm
  15. Kirsty Anderson

    WOW, this is awesome news. You kept that quiet, lol. I really feel this is a significant step forward, especially now you have the web management client.
    I look forward to running this up in a virtual machine instance very shortly.

    October 13, 2016 at 5:12 pm
  16. Bobby Jefferson

    Do we have a time frame on the faxing features? I really don’t want to go back to Windows.

    October 14, 2016 at 8:39 am
  17. tim stevenson

    OK so i installed V15 on debian 8, logged into the web config page OK. i didnt have time to config then so i shutdown. Now that i come back to it, i can’t connect to the web interface on port 5015? how do i make the web interface work again?

    October 16, 2016 at 2:42 am
    • tim stevenson

      its okay i found it
      sudo /usr/sbin/3CXWizard –cleanup

      October 16, 2016 at 2:47 am
    • @Tim It is a dev option but you can use it. Sudo and the wizard will start from scratch as if it were a new installation.

      October 17, 2016 at 9:33 am
    • That interface was a configuration command line. It is not the interface. The cleanup option will work in this case and you can choose to start that process again.

      October 17, 2016 at 9:33 am
  18. @Nicky After doing the Google Cloud setup, I get this Waiting for 0 seconds, press CTRL+C to quit …
    Checking if 3CX is responding in VM: 3cx VM-v15
    no port[s] to connect to
    3CX is not yet responding.
    waiting for 5 seconds

    Its been doing that for over 10 minutes. Did I mess up a step?

    October 27, 2016 at 12:12 am
  19. is very good this news

    October 31, 2016 at 12:19 am
  20. Wes

    When will the Fax service be completed?

    November 4, 2016 at 5:48 pm
    • By the end of the year….

      November 4, 2016 at 8:02 pm
  21. This is perfect: a 3GB Installation instead of a 16GB Windows Installation.
    I had an issue with the /etc/resolv.conf (DNS). The file was constantly overwritten with an IPV6 address (the Swisscom Router sends both IPV4 and IPV6 DNS). I worked around this by manually writing the IPV4 DNS and write protect the /etc/resolv.conf.
    A bit strange: on the same machine in the same network with Windows the Firewall test runs ok, with Linux it shows some ports as “failed”.

    November 6, 2016 at 9:42 am
  22. Some bad things ar happening behind!
    Sometimes when i’ll try to change the settings for extension numbers, and i’ll im about to safe it, it seems that the phone configurations seems to disappear. So i try to re- login using the refresh button. but then after typing my credentials, and hit login.. A message pop’s up just saying, Server error thats all, no background information to resolve the issue!

    November 6, 2016 at 8:32 pm
    • Use Chrome or Firefox incogneto window when accessing admin portal

      November 7, 2016 at 10:22 pm
  23. @Nicky when we can expect “Call Reporting” on linux?

    November 8, 2016 at 9:48 am
  24. Still would like to know how to restore/migrate a backup from V14 to 3CX for Linux. It seams that 3CX for Linux does not recognize the V.14 zip file?

    November 11, 2016 at 12:09 am
    • When the web console asks you for the backup upload it.
      V14 backups are allowed to be restored only at installation time. After you installed 3CX you cannot restore a v14 backup because the changes required are triggered at installation time (by installation time I mean from the moment you see the command line tool)

      November 11, 2016 at 9:28 am
  25. Hi Nicky
    I know very very little regarding Linux.have a raspberry pi but don’t really have the time to learn it..however I signed up for the OVH VPS SSD1 Linux package £2.50p/m
    They sent me the login credentials. Logged in via putty and found it was so easy to install. Very little Linux knowledge is needed. It was great. V15 has changed again in the latest service pack, the process is so easy to install and the hosted running costs are so cheap. We have previously been looking into buying a hosted tenanted solution in a data centre for up to 25 clients which could work out around £350 p\m as quoted by 2 companies But now it’s from £2.50pm per client. Amazing saving and I know want to learn more about Linux again.
    Thank you 3cx

    November 12, 2016 at 8:06 pm
    • Hi Geoff – Thank you so much for your feedback – thats great to hear. Yes this is indeed the way forward and we are working hard to make it even better including some centralized monitoring from the reseller portal. Thanks again for the headsup!

      November 13, 2016 at 3:17 pm
  26. Mr G247

    Hi There
    We have downloaded the free version and it works fine. I understand the interation for office365 isnt yet ready but on the Free Version Intergration with Outlook should be available but when you click on the Integration link to ADD nothing happens. is this also development?
    Within the OVH options there is ‘One Snap Shot’…If we set the backup for multiple instances eg 14 days can we restore from them ok, is the snap shot just the configuration of the Server?

    November 14, 2016 at 3:37 pm
  27. Ricardo

    Hi everyone.

    3cx have a date for the release of 3CX Debian version?

    Thank you.

    Best regards.


    November 22, 2016 at 1:11 am
    • Final release we have no date. But we released a beta update now.. You can test run the newly added features on linux including fax and reports.

      November 22, 2016 at 1:45 pm
  28. Please some one tel me how to restore the backups on to 3CX linux from a Windows backup?

    November 24, 2016 at 3:21 am
    • Even restoring from backup during the install fails. The zip file is over 800MB could that cause a problem?

      November 24, 2016 at 10:21 am
    • There are log files you can check to see why it is failing.

      November 24, 2016 at 10:28 am
  29. Simeon Roussimov


    OVH is a bad hosting solution. In their firewall you can only open 19 inbound ports which means you can not open your RTP range. Their solution is to rent a Cisco firewall from them and than you have more control. However, renting = higher cost. You can not use the same firewall for multiple servers. So each hosted machine will need a rented Cisco firewall from them. I would consider removing them as a recommended provider. Oh and according to them you have one more option – disable the firewall completely and have all ports opened. Not sure how “secure” that is.

    November 26, 2016 at 10:57 pm
    • Interesting. Maybe you can offer something better? Put forward your ideas and we will discuss.
      A) For 2.99 what do you expect? you want a cisco firewall included in that price also?
      B) You do not need the ovh firewall. i) If there is no listening socket then port open or closed is the same thing unless you are abusing on your machine and allowing users to install backdoors. But if you leave it stock and use it just for 3CX and block the end user from connecting to it (he does not need to anyway) then we are good. ii) Debian has iptables enabled so there is a firewall. Just not the ovh one. So yes – it is secure enough.
      All providers have limitations of what you can and cannot do – even giant Amazon has limitations.

      November 28, 2016 at 12:05 pm
  30. Mark Dutton

    Hi Nicky

    I posted earlier in this thread. I can’t seem to find the process to uninstall and reinstall so that I can change the internal IP address. We now have this situation where a customer gave us an IP address for a new install and when we got to site, they had also given it to someone else. We lost out and have to change it. What is the quickest way to uninstall well enough to reinstall and upload our backup please?

    December 8, 2016 at 1:47 am