Versions Compared

Version Old Version 1 New Version Current
Changes made by

Nathaniel Halbrooks

Merry Arpaia

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

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

Code Block
mkdir /usr/src/freepbx
cd /usr/src/freepbx
git clone ssh://
git@git
github.
freepbx.org/freepbx/framework.git
com/FreePBX
cd framework
git checkout release/13.0
./install_amp --installdb
Note

If you are on the FreePBX 7 Distro you can setup a development environment in less than 10 minutes. Check it out: Here

Table of Contents

GIT

FreePBX uses GIT, an open source version control system. If you are unfamiliar with GIT, you can learn more about it at http://git-scm.com/ . 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.orggithub.com/FreePBX which mirrors to github at https://github.com/freepbx

...

  1. Make sure you have added your SSH key to our GIT Server: http://git.freepbx.orggithub.com/FreePBX/plugins/servlet/ssh/account/keys

  2. Navigate to /usr/src

    Code Block
    cd /usr/src

  3. Checkout the devtools repo into this starting location

    Code Block
    git clone ssh://git@git.freepbx.orggit@github.com/FreePBX/freepbx/devtools.git

  4. Navigate to inside the devtools repo

    Code Block
    cd /usr/src/devtools 

  5. 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

    Code Block
    repo_directory=/usr/src/freepbx
language_directory=/usr/src/freepbxlocalization

  6. 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.

    Code Block
    ./freepbx_git.php --setup --switch=release/13.0

  7. Navigate to /usr/src/freepbx/framework

    Code Block
    cd /usr/src/freepbx/framework

  8. Run install with the '--dev-links' parameter. 

    Code Block
    ./install --dev-links

    Note you can add '-n' after '--dev-links', which will use secure defaults and passwords for all the services requred.

Note

When you add the --dev-links parameter, this significantly and fundamentally changes the layout of your FreePBX machine. This parameter sets up symlinks throughout all of FreePBX and renders online module updates unreliable, at best! You should never do this on a production machine as it can easily cause significant and unexpected problems.

Receiving an Error?

 

Code Block
PHP Fatal error:  Cannot redeclare composerRequire29de5ac29f36fb522a59e5e3da081c0a() (previously declared in /usr/src/freepbx/framework/amp_conf/htdocs/admin/libraries/Composer/vendor/composer/autoload_real.php:63) in /var/www/html/admin/libraries/Composer/vendor/composer/autoload_real.php on line 70

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:

...