Skip to end of metadata
Go to start of metadata

Install Ubuntu 12.04 Server LTS 32 or 64-bit

Commercial Modules

Commercial modules and add-ons are not currently supported on the Ubuntu platform. Commercial Modules can be purchased in the FreePBX Distro Market Place and are only supported on the FreePBX Distro platform.


Initial System Setup

Configure your root password.

Switch to the Root User

Update Your System

Install Required Dependencies

Install PearDB

You may receive a warning:

At this time it is safe to ignore that message

Reboot server

Install Dependencies for Google Voice

Install iksemel

Install and Configure Asterisk

Download Asterisk source files.

Compile and install DAHDI.

Compile and install LIBPRI.

Compile and install Asterisk

Install Asterisk-Extra-Sounds

Install and Configure FreePBX

Download and extract FreePBX.

Now create the Asterisk user and set ownership permissions.

A few small modifications to Apache.

Configure Asterisk database in MYSQL. 

Set permissions on MYSQL database.

Restart Asterisk and install FreePBX.

** If “. /install_amp” fails to run correctly, in terminal type:

Finally, one last mod and start FreePBX.

Start FreePBX


http://yourlocalipaddress/html or if you prefer http://localhost/admin

After you enable and update the modules in FreePBX You might see the following error.
Symlink from modules failed 

To correct this error do the following: 

Delete the list of failed files

Then on the FreePBX webUI go to the ‘Module Admin’ and uninstall and reinstall the ‘Camp On’ module. This should resolve the Symlink issue.

  • No labels


  1. Change asteriskuser to be asterisk

  2. Does this work on the Server or the Desktop edition, or both?  You should specify!

    Also, what about dependencies??  I'm almost certain that if I tried these commands on a server edition, it would fail for the lack of 15 different dependencies....

    1. It is a "phone server" why in the world would you install it on the desktop edition? A production system demands a production level server not a desktop. You could probably install it on the desktop edition but again why?

      Here is some basic info about the differences between desktop and server editions.

      This page does disclaim that this type of installation is for "Experts only"

      There is also a section of this document titled "Install Required Dependencies" which would seem to cover installing dependencies.

      Have you tried the procedure? If you have please help the community by listing any dependencies that may have been missed.

  3. Good technical documentation is as specific as possible.  If this was written by someone using Server, that should be indicated.  I've spent the last two days trying to get something to build on Server without success.  I'm pretty sure that whoever wrote the documentation did it on a Desktop edition, which has many dependencies that are not included on the Server version.

    I don't believe that all of those dependencies were listed when I wrote my comment.  If they were, I somehow missed them. 

    1. Martin,

      I wrote the documentation and I wrote it based on server (and I wrote it WHILE I did it) and the dependencies have been there for over a year now. You can see all of this by just simply looking at page history:

      Please keep in mind that I do know what I'm doing when it comes to technical writing and if you would have followed the documentation it wouldn't have mattered if you were on desktop or server (however on the desktop version you'd have a completely useless CPU sucking gui running).

      As is how all of these *nix distros work, you can easily turn a desktop version into a server version, you don't even have to change the yum or apt-get repo server addresses.

  4. Hi Guys,

    I'm trying to run this documentation in order to make my asterisk server working on Ubuntu 12.04 Dekstop version (on VM VirtualBox)

    I did all the steps and when trying to go to the webrowser to point to my local ipadress, i got this error message:

    Not Found

    The requested URL /admin was not found on this server.

    Apache/2.2.22 (Ubuntu) Server at Port 80Could tou please give me help ?Thanks in advance.
    1. try: freepbx/admin

  5. Firewall?

    Also, if you're running this in a VMWare, I'd recommend going with the pre-compiled, ready to go ISO that you can download from here:

  6. Firstly, Thank you for your effort.

    I have a question. In this manual, we used asterisk ver.11. but i checked asterisk ver. in freepbx.

    so i check again asterisk version in ubuntu using 'asterisk -rvvv'.

    and i saw 'Connected to Asterisk currently running on ...'

    what is Asterisk ??? Is this version possible to use video conference??

    I have to configure video conference... TT

    I'm waiting for your reply.. Thank you (smile)

  7. Thanks a lot for this work. We successfuly install FreePBX on Ubuntu server 12.04 64bits running on Windows 2008 R2 Hyper-V virtual machine... All services are working, but I think we miss someting: "http://myipaddress" get me a "It works!" page... http://myipaddress/freepbx/admin get me a "Forbiden" page... We are testing using Windows 2008 R2 IE browser... Thanks for any help. Regads, Luiz 

  8. Would the Free PBX install instructions work correctly on a later version of Ubuntu (13.10 for example) ? Paul

  9. I followed these instructions using an AWS EC2 Micro instance running Ubuntu 12.04 64bit ed.I

    Installation was going well up until:

    Set permissions on MYSQL database.


    mysql -u root -p -e "GRANT ALL PRIVILEGES ON asterisk.* TO asteriskuser@localhost IDENTIFIED BY '${ASTERISK_DB_PW}';"
    mysql -u root -p -e "GRANT ALL PRIVILEGES ON asteriskcdrdb.* TO asteriskuser@localhost IDENTIFIED BY '${ASTERISK_DB_PW}';"
    mysql -u root -p -e "flush privileges;"


    Restart Asterisk and install FreePBX.

    ./start_asterisk start
    When I started asterisk it perpetually restarted.
    What did I do wrong?
    I had to terminate the instance, I am going to start over tomorrow but I've not found this described elsewhere.


  10. To: Fr08 That is a known AWS bug. Apparently asterisk is compiled with flags that EC2 micro instance does not support and hence asterisk crashed on start. Due to the presence of safe_asterisk the asterisk is then continuously restarted (and it crashes each time naturally).  

  11. Hi Guys


    I have a strange problem with freepbx; I followed this guide and the i've installed the pbx on my ubunti server 12.04.

    Now after the installation of freepbx and the upgrade of modules , all sip extensions failure to register..can you help me?



  12. Running Ubuntu 14.10 I had to modify /etc/apache2/sites-available/000-default.conf and change the 'DocumentRoot' value to /var/www/admin otherwise I received a 404 Page Not Found when navigating to http://<serverIP>/


    EXCELLENT write up though!! Everything worked/installed 99.99% perfectly!

    <I'm running my Ubuntu on Microsoft Azure trunking to ThinkTel and Skype for Business Server 2015!>