Manual Setup with a web server (Linux/Mac OS)

Linux/Mac OS: manual installation instructions


This page is not yet fully completed - we are still working on the content here. Expect some rough edges 🙃

Fundamental Installation

1. Install composer

First you need to install the dependency manager Composer (if you don’t have it already):

curl -sS | php

By issuing this command Composer will get downloaded as composer.phar to your working directory. If you like to have composer installed globally, you can simply move it to a directory within your $PATH environment.

mv composer.phar /usr/local/bin/composer

Windows users

If you are on Windows please refer to the offical documentation on how to install Composer on Windows
2. Create a new project

Go to your htdocs directory and create a new project based on the Neos base distribution:

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

Composer will take care of downloading all dependencies for running your Neos installation to the directory Neos. You can safely delete the vcs files by answering ‘Y’ to the question ‘Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?’.

3. Virtual domain/host

Next set up a virtual domain/host in your webserver configuration

Set up a virtual host inside your Apache configuration. Set the DocumentRoot to the Web directory inside the Neos installation. Set the directive AllowOverride to ALL to allow access to .htaccess

NameVirtualHost *:80 # if needed

<VirtualHost *:80>
  DocumentRoot "/your/htdocs/Neos/Web/"
  # enable the following line for production context
  #SetEnv FLOW_CONTEXT Production
  ServerName neos.demo

<Directory /your/htdocs/Neos/Web>
  AllowOverride All

Make sure that the mod_rewrite module is loaded and restart apache. For further information on how to set up a virtual host with apache please refer to the Apache Virtual Host documentation.

For further information on how to set up a virtual domain with nginx please refer to the nginx documentation.

Add an entry to /etc/hosts to make your virtual host reachable: neos.demo

Make sure to use the same name you defined in ServerName in the virtual host configuration above.

4. Set file permissions

Set file permissions as needed so that the installation is read- and writeable by the webserver’s user and group:

sudo ./flow core:setfilepermissions john www-data www-data

Replace john with your current username and www-data with the webserver’s user and group.

For detailed instructions on setting the needed permissions see Flow File Permissions.

Setting file permissions is not necessary and not possible on Windows machines. For Apache to be able to create symlinks, you need to use Windows Vista (or newer) and Apache needs to be started with Administrator privileges.

5. Visit the setup

Now, go to http://neos.demo/setup in your browser, and you get redirected to the setup tool.

Following Guide: Running the Setup Tool