Installation

Internet Connection VoIP test
If you are going to be using SIP connections for incoming/outgoing calls it is helpful to know if your internet connection is going to be able to handle it. Speed tests like this one http://myspeed.visualware.com/voip/ are helpful in checking your connection.

Installation
FusionPBX is multi-platform and can be installed on many operating systems.

If you are wanting to install FusionPBXon an existing FreeSWITCH system then you should choose the relevant platform below and follow the appropriate instructions (before starting this, do note the warnings further down this page about the implications for your existing FreeSWITCH installation).

If you are just wanting to test FusionPBX simply, then the best place to start is one of the ISO installs as it will get you up and running quickly (note that the draw back with ISO installs is that they normally start by erasing your harddrive so you need an unused machine to try them on OR you can try them in a virtual machine such as VirtualBox or VMware).

Below are instructions that have been provided for a few of the operating systems if yours is not listed the ones that exist should hint towards the general install process.

Scripted Installs

 * New appliance install - A scripted install to to get your FusionPBX appliance up and running in no time.


 * New Debian Deb's Package install - A scripted install to to get your FusionPBX server up and running in no time.


 * Easy FusionPBX - A scripted install that currently supports Debian Squeeze, Ubuntu 10.04LTS, and Ubuntu 12.04LTS.


 * CentOS 6.2 with PostgreSQL


 * Debian Wheezy with PostgreSQL After installing Debian a scripted install makes the rest a breeze even for newbies.

ISO Install

 * ISO based installs: (ideal for people with no linux experience or people who just want a fast way to test FusionPBX out)
 * These isos are really old. you probably shouldn't use them until they are updated.
 * CentOS ISO - An ISO based on Centos 5.4
 * Ubuntu ISO An Ubuntu 10.04 FreeSWITCH/FusionPBX LiveCD/Installer (32-bit for now)]]
 * This is a good way to try things out. For permanent machines it is recommended that you use the scripted install.

Manual Install

 * Installing from scratch - Linux & Unix OS variants:
 * FreeBSD Install
 * CentOS Install
 * Debian Install
 * Ubuntu Install
 * FreeSWITCH compile
 * OpenWRT http://tech.psgv.ca/2011/06/installing-fusionpbx-on-openwrt-wip/

Mac

 * Installing from scratch - Mac OS:
 * Mac OS X Install

Windows

 * Installing from scratch - Windows:
 * Windows Install
 * Web Platform Installer

Raspberry Pi

 * Raspberry Pi Script Script install

pfSense 1.2 & 2.0

 * pfSense Install -- broken/missing URLs

pfSense 2.1

 * pfSense EasyInstall script
 * pfSense FusionPBX package
 * Installing FusionPBX behind pfSense

Other Installs:
[If you need to run the FusionPBX install.php again simply remove the includes/config.php file then browse to the index.php page on the root of the website - if you want to reinitialize the database, drop the entire DB, not just the tables]
 * Embedded Image
 * G729 Install
 * VPS Specific
 * ChunkHost Install

Installing onto an existing FreeSWITCH system
Installing FusionPBX onto an existing install of FreeSWITCH will reset all your files in the FreeSWITCH conf folder to the FusionPBX defaults. Although FusionPBX tries to make a backup of your config, located in the folder conf.orig, it is still a good idea to back them up.

Comments from IRC conversation about this:
 * the main thing overwritten during the install would be freeswitch's default dialplan
 * in fusionpbx I prefix most files with a v_ that way fusionpbx indicates to you the majority of the files it creates
 * the autoload_config files are not renamed but extensions, inbound routes, ivr menu, outbound routes, and dialplan entries uses the v_ file prefix and the gui ignores files without that prefix allowing you to have custom settings anywhere you want in the config. Fusionpbx doesn't import the custom settings
 * the difference between freeswitch default dialplan is that the feature codes are prefixed with a * to free up numbers for user defined things and allow extension numbers to be whatever you want between 2-7 digits
 * great care has been made to let people access to controlling freeswitch at any level desired with fusionpbx with as little or as much as you want. The gui has been designed to make it easier to use freeswitch but also have had smart people in mind as well

Testing:

 * http://doc.pfsense.org/index.php/FreeSWITCH#General_Tips
 * http://doc.pfsense.org/index.php/FreeSWITCH

Editing the config safely
Guide to Editing Config Files Safely. FusionPBX guide for editing the config files manually. Got a handle on the graphical interface and want to dig deeper into the power of FreeSWITCH? This guide describes what files are written by FusionPBX and should help indicate what files can be edited without losing changes.


 * http://www.fusionpbx.com/index.php?c=/editingconfigfiles.php

If your menus don't show
Go to http://domain_or_ip/core/menu/menu_list.php and press Restore Default. That should fix it.

Links

 * FusionPBX.com
 * FreeSWITCH.org