MAMP Setup (Windows/Mac OS)

For Windows, Mac OS, using MAMP allows an easy start into Neos.

Written by
Sebastian Helzle

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


2. Adjust the MAMP PHP configuration

Enable the OPcache feature which will speed up Neos:

MAMP PHP configuration

Change to PHP to 7.3 and Cache to OPcache


3. Install composer if necessary

If you haven't installed composer yet, follow the second step in the general composer instructions. Then continue with this guide.


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:

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 in your browser and get redirected to the Neos setup.

Use root as username and password in the database screen. 

Use as database host.

Written by