Installing AMPPS locally on Mac OS X

AMPPS is a WAMP, MAMP and LAMP stack of Apache, MySQL, and PHP.

You can easily run AMPPS locally on Windows, Linux and Mac OS X by downloading it from here ( http://www.ampps.com/downloads) and following the instructions relevant to your operating system ( http://www.ampps.com/wiki/Main_Page). This will give you a means of working with Jamroom whilst offline, very convenient whilst developing for Jamroom, or just keeping a working local copy of your site.

The quickest way is to install Jamroom using the Softaculous installer (which comes with Ampps) by following the One Click Install Using Softaculous step below, but I do it manually (2 additional Manual Installation steps), and it still only takes a few minutes.

1. Download from here: http://files.ampps.com/AMPPS-2.5.dmg

2. Mount the dmg by double clicking it.

3. Drag the AMPPS folder to your Applications folder.

4. You will need to be connected to the internet the first time you run Ampps. You can run it by opening the app here: /Applications/AMPPS/Ampps.app

5. Follow the instructions to secure your Ampps installation.

Ampps won't run Jamroom until you do the following tweaks to the default configuration:

1. Enable ctype and iconv extensions:
In the Ampps control centre, click PHP, then Php Extension.
In the window which opens, enable ctype.so and iconv.so, then save.

2. Enable mod_deflate:
In the Ampps control panel, click Apache, then Configuration.
In the configuration file, search for mod_deflate, and uncomment the following line.
LoadModule deflate_module modules/mod_deflate.so
Then save.

Restart Apache from the Ampps control panel.

Note: The above is true for php5.5, probably true for other versions. There is currently a Yosemite bug in ampps, to upgrade to php5.5 (from the default 5.3) you need to start apache from the command line rather than from the control panel. The other php versions will then appear in Ampps control center > PHP > Change php version.
This is the command to paste into Terminal:
(stop apache first if it is already running)

On the main Ampps Admin page click the Secure AMPPS icon and follow any instructions to secure your installation. You can check and change this by clicking the Security Center icon.

You might also want to delete the ampps user from the mysql user table in phpmyadmin.

First thing to do is to create your site in the Ampps Control Centre.

1. Click the Admin icon (it looks like a house), or visit https://localhost/ampps-admin and then log in using the username "soft" and the password you entered during the first run.

2. Click the Add Domain icon, then enter the domain you want to use, probably something like local.yoursite.com. If you want ssl set up for your site, check that box as well. Then click the Add Domain button create your site.

If you want to install Jamroom manually skip this step.

1. You can find the Softaculous Jamroom installer from the Ampps main admin page by typing Jamroom into the search box top right, click Jamroom in the dropdown.

2. The Jamroom installer page will open, click the blue Install button.

3. Choose your Protocol, select the domain you just created, "In Directory" should be blank if you want your Jamroom in the root of your domain.

4. Enter your choice of Jamroom admin username, password and email, then click Install.

Once the installer has run a page will load giving you the url to visit to log into your new Jamroom site. You can skip the next two Manual Installation steps below (Softaculous has done those for you) but you will probably want to follow the last two steps for fixing ffmpeg on Mac and fixing email delivery.

If you need to access your database details in the future you can get them from the Installation details at the bottom of the Overview tab on the Softaculous Jamroom pages. You can also backup or delete the installation from here.

On the Ampps admin page, click the Add Database icon and phpMyAdmin will open.

Create your database. You can optionally create a database user for each site, or just use "root" as the user with the password you entered during Ampps installation.

Download the latest Jamroom files from here: https://www.jamroom.net/download

Then unzip, find the unzipped folder and move the files from it into your site folder which will be in /Applications/AMPPS/www/local.yoursite.com

Then visit http://local.yoursite.com in your browser and follow the instructions given by the Jamroom installer. You will need to enter your database name, database user and database password.

When you run the Jamroom System Check, it will show that ffmpeg is not working. Replace the file /Applications/AMPPS/www/local.yoursite.com/modules/jrCore/tools/ffmpeg with the relevant download from here: http://ffmpegmac.net/
You don't need to do this unless you need to use all of the audio functions locally. You will need to replace this file for each local Jamroom site you install.

Install and configure the Jamroom Mailgun module to get all email functions working locally.