29th May, 2017 | Tutorials |

How to Install Neos CMS on CentOS 7

Want your very own server? Get our 1GB memory, Xeon V4, 25GB SSD VPS for £10.00 / month.

Get a Cloud Server

Neos is a free and open source content management system. It is written in PHP and uses its own framework flow. Neos is highly customizable and extensible. The content on the site can be edited very easily, you just need to click on the content and you can edit it right away. It provides tools so you can easily create a multilingual site. It provides many more features such as Multisite capabilities, Human readable URLs, Reviews and Workflows, Users and Roles, Package Manager, Templates etc.

In this tutorial, we will install Neos on CentOS 7 server.


Neos CMS does not require any special hardware requirements. It can be installed on servers with a small amount of RAM. All the required dependencies will be installed throughout the tutorial. You will need a minimal installation of CentOS 7 with root access on it. If you are logged in as a non-root user, you can run sudo -i to switch to root user.

Installing Neos

Before installing any package it is recommended that you update the packages and repository using the following command.

yum -y update

Once you have your system updated, you can proceed to install the LAMP stack. Start the LAMP installation by installing Apache web server and MariaDB, which is a fork of MySQL using the following command.

yum -y install httpd mod_rewrite mariadb-server mariadb

Neos can be installed on any version of PHP greater than 7.0. PHP 7 is not included in default YUM repository, hence you will need to add the Webtatic repository in your system. Webtatic repository requires EPEL repository to work. Run the following command to install EPEL repository.

yum -y install epel-release yum -y update

Now install Webtatic repository using the following commands.

rpm -Uvh yum -y update

To install PHP 7.1 and all the required PHP modules, run the following command.

yum -y install php71w php71w-mbstring php71w-pdo_mysql php71w-cli php71w-tokenizer php71w-pecl-imagick

Once you have PHP installed, you can check the version of PHP using the following command.

php -v

You should get output similar to this.

[root@liptan-pc ~]# php -v
PHP 7.1.5 (cli) (built: May 12 2017 21:54:58) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies

Now start Apache web server and enable it to start at boot time using the following command.

systemctl start httpd systemctl enable httpd

To start MariaDB and enable it to start at boot time using the following commands.

systemctl start mariadb systemctl enable mariadb

Now run the following commands to secure your MySQL or MariaDB installation.


It will run a small script which asks you to provide the root password for MariaDB. As we have just installed MariaDB, the root password is not set, just press enter to proceed further. It will ask you if you want to set a root password for your MariaDB installation, choose y and set a strong password for the installation. It will also ask you for removing test databases and anonymous users. Most of the questions are self-explanatory and you should answer yes or y to all the questions.

To create a database we will need to login to MySQL command line first. Run the following command for same.

mysql -u root -p

This will prompt you for the password, provide the root password of MySQL which you have set earlier. Now run the following query to create a new database for your Neos installation.


The above query will create a database named neos_data. Make sure that you use semicolon at the end of each query as the query always ends with a semicolon. Once the database is created you can create a new user and grant all the permissions to the user for the database. Using root user is not recommended for the databases. To create a new database user, run the following query.

CREATE USER 'neos_user'@'localhost' IDENTIFIED BY 'StrongPassword';

The above query will create a user with username neos_user. You can use any preferred username instead of neos_user. Replace StrongPassword with a strong password. Now provide the appropriate privileges to your database user over the database you have created. Run the following command.

GRANT ALL PRIVILEGES ON neos_data.* TO 'neos_user'@'localhost';

Now change the character set of your database to utf8 using following query.

ALTER DATABASE neos_data charset=utf8;

Now run the following command to immediately apply the changes on the database privileges.


Exit from MySQL prompt using exit command.

Now you will need to install Composer. Composer is a dependency manager for PHP.

curl -sS | php mv composer.phar /usr/bin/composer

Now switch to the webroot directory of Apache web server and download Neos using following command.

cd /var/www/html composer create-project --no-dev neos/neos-base-distribution neos

Now you will need to create a virtual host for your web application. Run the following command for same.

nano /etc/httpd/conf.d/

Paste the following lines into the file.

<VirtualHost *:80>
    DocumentRoot "/var/www/html/neos/Web"
    <Directory "/var/www/html/neos/Web">
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
        Require all granted
    ErrorLog "/var/log/httpd/"
    CustomLog "/var/log/httpd/" combined

Replace with any domain or subdomain you want to use to access the application. Save the file and exit from the editor. Run the following command to restart your Apache server.

systemctl restart httpd

Now you will need to provide the ownership of the application to web server user using the following command.

cd /var/www/html/neos ./flow core:setfilepermissions root apache apache

You may also need to allow HTTP traffic on port 80 through the firewall if you are running one. Run the following commands to do so.

firewall-cmd --zone=public --permanent --add-service=http firewall-cmd --reload

You will also need to disable SELinux. To temporary disable SELinux without restarting the server, run the following command.

setenforce 0

To completely disable the SELinux you will need to edit /etc/selinux/config file.

nano /etc/selinux/config

Find the following line:


Change it to:


Now complete the installation using a web browser, go to the following link using your favourite web browser.

You will see the following page.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/1936087944.png" alt="" />

The installer will now build the cache and will generate the setup password. Once it is done, you will be redirected to next page asking for setup password.

To obtain the setup password run the following command in terminal.

cat /var/www/html/neos/Data/SetupPassword.txt

You will see following out which includes the password.

[root@liptan-pc neos]# cat /var/www/html/neos/Data/SetupPassword.txt
The setup password is:


After you successfully logged in, this file is automatically deleted for security reasons. Make sure to save the setup password for later use.

Enter the password in the web interface.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/1540050693.png" alt="" />

Click Login button to continue. In next interface, it will check for the setup requirements. The installer will automatically choose imagick module for image manipulation.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/1786592170.png" alt="" />

Click Next to proceed further. In next interface, you will need to provide the database information.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/567457801.png" alt="" />

Select MySQL/MariaDB via PDO Database driver. Provide the username and password which you have created earlier. Once you provide the DB user details, the installer will automatically scan the database associated with the user. Select the database and click Next to go to the next step. In this step, you will need to create a new administrator account.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/575256460.png" alt="" />

Provide the administrator details and click Next to continue. In next step, you will be asked how you want to create your site.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/422597578.png" alt="" />

Click Next to create the site using the Site package. The site will now be imported and you will see the success message. You can now access the frontend of your site on which will look like this.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/615825531.png" alt="" />

To access the backend of your site, go to the following link. which will look like this.

HP_NO_IMG/data/uploads/users/96ef1f90-83ed-46f0-9b58-aa6ee50a1451/527124437.png" alt="" />


In this tutorial, we have learned to install Neos CMS on CentOS 7 server. You can use this content management system to create beautiful personal sites or business site.

Want your very own server? Get our 1GB memory, Xeon V4, 25GB SSD VPS for £10.00 / month.

Get a Cloud Server