Downloading Neos

This page has instructions to install Neos with composer, which downloads Neos and all of it's dependencies.


Find the compatibility matrix for all versions here.


Neos of course requires a database. We support all databases which are compatible with Doctrine DBAL. We currently ship database migration scripts for MySQL/MariaDB and PostgreSQL, so use one of them if possible. If you are using an MySQL based database you must use at least MySQL 5.7.x or MariaDB 10.2.x


Make sure you have PHP 7.1 or later installed. Also Neos needs the PHP CLI binary to be available in the same version as well. 

The default settings and extensions of the PHP distribution should work fine, but it doesn't hurt checking if the PHP modules mbstringtokenizer and pdo_mysql are enabled, especially if you compiled PHP yourself.

Make sure the PHP functions system(),shell_exec()escapeshellcmd()and escapeshellarg()are not disabled in your PHP installation. They are required for the system to run.

Web Server (for production use)

Not surprisingly, Neos needs a web server to run (at least for productive usage). We recommend that you use Apache or nginx (though IIS and others work too). Please make sure that the mod_rewrite module is enabled.

For development, we recommend to run Neos by using the internal server of PHP by executing ./flow server:run in the directory where you have installed Neos, as this is the easiest way to get started. This is what we explain below.

For more information on the system requirements check the relevant part of the Flow documentation.

How to install and run Neos locally


1. Installation of Composer

First of all, we need to install composer, if you've already got composer installed on your system, you can safely move on to the next step.

curl -s | php

This will download the composer binary to your current directory. 

2. Installation of Neos

Afterwards we can begin installing Neos. In an empty folder of your choice, execute the following command. 

php /path/to/composer.phar create-project --no-dev neos/neos-base-distribution .

This command creates the necessary folder structure and downloads Neos with all of its dependencies.

Please note: You need to adjust the path pointing to the composer binary which you've downloaded in the first step.

3. Starting Neos

For development or to try Neos on your own machine, you can start a simple PHP web server with the following command:

./flow server:run

Please note: You need to have a Doctrine compatible database server, like MySQL, running on your system.

This step is not required if you install Neos on a hosting provider, or use a local web server. For production we do recommend using a web server like apache or nginx in any case. 

Installing Neos on a shared hosting provider? Make sure to configure Neos to use the correct PHP version.

4. Setup

After composer finished downloading the dependencies, open the configured domain for the directory in your favorite browser. Please note that you need to visit the /setup page.

5. Done

After you've completed filling out all necessary infos in the setup, you are up and running. You can visit either the frontend or the backend by appending /neos to your url.

Do you want to create a new site? We recommend you to start reading the latest documentation, and if you need any help, get in touch with us, we are eager to help you!