Setting Up a Development Environment from a Non-Distro Machine
- Nathaniel Halbrooks
If you aren't going to work in --dev-links mode (meaning you would like a standard install of FreePBX 12) then do NOT follow the rest of this guide, failure to not adhere to these warning will only cause headaches for you, especially if you don't understand how FreePBX functions internally, instead run
mkdir /usr/src/freepbx
cd /usr/src/freepbx
git clone ssh://git@git.freepbx.org/freepbx/framework.git
cd framework
git checkout release/13.0
./install_amp --installdb |
If you are on the FreePBX 7 Distro you can setup a development environment in less than 10 minutes. Check it out: Here
GIT
FreePBX uses GIT, an open source version control system. If you are unfamiliar with GIT, you can learn more about it at Git . If you are already familiar with Subversion, you may be interested in checking out http://git.or.cz/course/svn.html for a brief crash course based on your Subversion knowledge. Because GIT is based on a distributed system there is no 'one' central server as there was with SVN. However we consider our master server to be http://git.freepbx.org which mirrors to github at FreePBX
Supported Modules
Supported Modules are modules that are actively supported by the FreePBX development team and are supported by FreePBX's Sponsor, Sangoma Technologies, INC. They can be found in our standard project FreePBX or on our mirror at FreePBX
Contributed Modules
Contributed modules are modules that have been submitted to the FreePBX development team to host, they are very inactive and sometimes don't have a developer attached to them. They can be found in our contributed modules project FreePBX or on our mirror at FreePBX Contributed Modules
Initial Setup
FreePBX 14 Warning
Note that FreePBX 14 requires PHP 5.6 or higher to run. Currently, no patches or pull requests will be accepted to make it run on PHP 5.5 or lower. Your development environment MUST have PHP 5.6 or higher. The easiest way to accomplish this is to install FreePBX Distro 7 and then run 'yum install freepbx-devel'
Make sure you have added your SSH key to our GIT Server: http://git.freepbx.org/plugins/servlet/ssh/account/keys
Navigate to /usr/src
cd /usr/srcCheckout the devtools repo into this starting location
git clone ssh://git@git.freepbx.org/freepbx/devtools.gitNavigate to inside the devtools repo
Install your default configuration settings to the config file (create a file in your home directory called .freepbxconfig and put the information below in it)
.freepbxconfig
Run the freepbx_git.php setup script. This script will download all of the repos from the FreePBX Project, excluding devtools, into /usr/src/ (unless you specify somewhere else using --directory). When prompted for your Username and Password, please use your FreePBX.org Username and Password.
Navigate to /usr/src/freepbx/framework
Run install with the '--dev-links' parameter.
Note you can add '-n' after '--dev-links', which will use secure defaults and passwords for all the services requred.
Receiving an Error?
This is caused because you have an existing installation of FreePBX and our installer will not override a real file with a symlink. To fix it we should, perform the following after backing up any changes you in /var/www/html:
Open /etc/freepbx.conf and get the database credentials (save them in a safe place)
Remove /etc/freepbx.conf & /etc/amportal.conf
Remove /var/www/html/
cd /usr/src/freepbx/framework
./install --dbuser=[username from /etc/freepbx.conf] --dbpass=[password from /etc/freepbx.conf] --dev-links
Maintenance
Updating Modules
Navigate to your devtools directory
Run freepbx_git with --refresh
Checking Out Modules from Contributed
Navigate to your devtools directory
Check out the module using the raw name (a list of modules can be seen here: FreePBX