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.

System Requirements

Server Environment

Not surprisingly, you'll need a web server for running TYPO3 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.

TYPO3 Neos requires a database supported by Doctrine DBAL.

PHP

Make sure you have PHP 5.3.2 or later available on your web server. Make sure your PHP CLI binary is the same version! If available, you should use PHP 5.6 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. You really should (not only because of TYPO3 Neos) turn off magic quotes in your php.ini (magic_quotes_gpc = off).

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

For more information on the system requirements check the relevant part of the TYPO3 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 https://getcomposer.org/installer | 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 TYPO3-Neos-1.2

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/TYPO3-Neos-1.1/Web/"
    # skip the following line for development
    SetEnv FLOW_CONTEXT Production
    ServerName neos.demo
    </VirtualHost>
  • Add an entry to /etc/hosts:
    127.0.0.1 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 requested version numbers
composer require --no-update "typo3/neos:dev-master"
composer require --no-update "typo3/neos-nodetypes:dev-master"
composer require --no-update "typo3/neosdemotypo3org:dev-master"
composer require --no-update "typo3/neos-kickstarter:dev-master"
composer require --no-update "typo3/buildessentials:dev-master"
# actually update the packages
composer update
# Remember to flush the caches afterwards
./flow flow:cache:flush --force
./flow doctrine:migrate