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.
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.
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.
First install composer like this:
curl -s https://getcomposer.org/installer | php
Then go to your webserver document root directory and download the Neos base distribution with all the dependencies:
php /path/to/composer.phar create-project --no-dev typo3/neos-base-distribution Neos-2.1
Continue with the setup step now.
NameVirtualHost *:80 # if needed
# skip the following line for development
SetEnv FLOW_CONTEXT Production
./flow flow:core:setfilepermissions <commandline user> <webserver user> <webserver group>
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
By using composer, you can switch to the most recent master, in order to test the latest changes:
# update composer.json according to https://github.com/neos/neos-base-distribution/blob/master/composer.json
# actually update the packages
# Remember to flush the caches afterwards
./flow flow:cache:flush --force