Installing AMPPS locally on Mac OS X

  • About AMPPS

    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 ( and following the instructions relevant to your operating system ( 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.
  • I'd like feedback on this documentation, so let me know if you install successfully, if anything is not clear and can be improved, or if anything goes wrong at any stage. Doing an ampps installation is something you do once in a blue moon - the previous time I did this was several years ago, so immediate feedback will be much appreciated. Add a comment, send a PN, an email, or post in the Ultrajam General forum. Thanks!
  • Installing AMPPS 2.5 on Mac OS X 10.10

    1. Download from here:

    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/

    5. Follow the instructions to secure your Ampps installation.
  • Configuring Ampps to run Jamroom

    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 and, 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/
    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:
    sudo /Applications/AMPPS/apache/bin/httpd -k start
    (stop apache first if it is already running)
  • Securing Ampps

    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.
  • Setting up your domain

    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 If you want ssl set up for your site, check that box as well. Then click the Add Domain button create your site.

  • One Click Install Using Softaculous

    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.
  • Important step this!

    If you like Jamroom please submit a rating to Softaculous. You will find a Ratings tab on the Jamroom installer page of your Ampps admin pages here:

    You can also add a review from the Review tab.
  • 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.
  • Manual Installation: Create the database

    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.
  • Manual Installation: Install Jamroom

    Download the latest Jamroom files from here:

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

    Then visit 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.
  • Fix ffmpeg

    When you run the Jamroom System Check, it will show that ffmpeg is not working. Replace the file /Applications/AMPPS/www/ with the relevant download from here:
    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.
  • Fix Email delivery

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