Download Neos

This page has instructions to install Neos with composer, which downloads Neos itself. If you don't want to use composer, then download an archive instead. After having installed either way, continue to set up Neos as explained further down.

Note: If you want to learn more about which versions we support, and how we decide when to do a new release, please see our All about Releases page. If you are looking for details on the development process, start at the Contribute page.

System Requirements

Server Environment

Not surprisingly, you'll need a web server for running Neos. We recommend Apache or nginx (though IIS and others work too – we just haven't really tested them). Please make sure that the mod_rewrite module is enabled.

Neos requires a database supported by Doctrine DBAL. We currently ship database migration scripts for MySQL and PostgreSQL


Make sure you have PHP 5.5 or later available on your web server. Make sure your PHP CLI binary is the same version! If available, you should use PHP 7 as it improves performance compared to earlier versions. Generally, a newer PHP version is better.

The default settings and extensions of the PHP distribution should work fine, but it doesn't hurt checking if the PHP modules mbstring, tokenizer 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.

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

Installation from an Archive

Installing Neos from an archive is convenient if you just want to try Neos and for the first steps. If you want to dive deeper into Neos and create a real site with it, we recommend using the installation via composer, instead.

First download the archive for the Neos version you want to install. Then unpack the archive to your webserver document root directory and continue with the setup.

Installation via Composer

First install composer like this:

curl -s | php

Then go to your webserver document root directory and download the Neos base distribution with all the dependencies:

cd /your/htdocs/
php /path/to/composer.phar create-project --no-dev typo3/neos-base-distribution Neos-2.1

Continue with the setup step now.

Setting up Neos

  • Set up a virtual host inside your apache.conf, and then restart apache:
    NameVirtualHost *:80 # if needed

    <VirtualHost *:80>
    DocumentRoot "/your/htdocs/Neos-2.1/Web/"
    # skip the following line for development
    SetEnv FLOW_CONTEXT Production
    ServerName neos.demo
  • Set file permission as needed (see also this section of the Flow documentation):
    cd /your/htdocs/Neos-2.1
    ./flow flow:core:setfilepermissions <commandline user> <webserver user> <webserver group>
  • Add an entry to /etc/hosts: neos.demo
  • Go to http://neos.demo/setup and follow the on-screen instructions!


Updating an existing installation

To update an existing installation to the latest patch release you can update the packages this way:

composer update --no-dev "typo3/*"
# Remember to flush the caches afterwards ./flow flow:cache:flush --force
./flow doctrine:migrate

Switching to the development master

By using composer, you can switch to the most recent master, in order to test the latest changes:

cd /installation-root/
# update composer.json according to
# actually update the packages
composer update
# Remember to flush the caches afterwards
./flow flow:cache:flush --force
./flow doctrine:migrate