MAMP Setup (Windows/macOS)

For Windows & macOS, using MAMP allows an easy start into Neos.

What is MAMP

MAMP is a free, local server environment that can be installed under macOS and Windows with just a few clicks.

MAMP Pro adds some more features which can be useful when working on multiple projects at the same time.

#Step by Step Instructions

#1. Install MAMP or MAMP Pro

Download and install MAMP according to the instructions on mamp.info

#2. Adjust the MAMP PHP configuration

Enable the OPcache feature which will speed up Neos:

MAMP PHP configuration

Use the supported PHP version and change the Cache to OPcache

#3. Install composer if necessary

Composer is the PHP dependency manager, similar to NPM for Node.js, or Maven for Java. If you do not have it installed yet, you need to install it now because it is the way to install Neos then.

bash
curl -sS https://getcomposer.org/installer | php
bash
mv composer.phar /usr/local/bin/composer

You may check your composer's version by typing “composer -V” ...

Please consult the offical documentation on how to install Composer on Windows.

#4. Install Neos with composer

Open your terminal and go to the htdocs folder in your MAMP installation. On Mac OSX that would be in "/Applications/MAMP/htdocs".

There run the following command:

bash
composer create-project neos/neos-base-distribution neos-example

#5. Adjust the MAMP webserver configuration

Change the root folder for your project to the "Web" subfolder of your new Neos project.

MAMP webserver configuration

Change the root folder to the Web subfolder of Neos

#6. Visit the setup

Go to http://127.0.0.1:8888 in your browser and get redirected to the Neos setup.

Use root as username and password in the database screen. 

Use 127.0.0.1:8889 as database host.

Following Guide: Running the Setup Tool

Written by