- \n
- Run multiple sites in a single instance.<\/li>\n
- Provides human readable out of the box. No requirements or setup needed.<\/li>\n
- Allow us to create a user, assign roles and restrict access to administrative and editing features.<\/li>\n
- Neos is built for easy deployments and the use of version control systems in mind.<\/li>\n<\/ul>\n
In this tutorial, I will explain how to install and configure Neos CMS on CentOS 7 server.<\/p>\n
Requirements<\/h2>\n
- \n
- A server running CentOS 7.<\/li>\n
- A not-root user with sudo privileges.<\/li>\n<\/ul>\n
Getting Started<\/h2>\n
Before starting, it is recommended to update the system with the latest version. You can do this with the following command:<\/p>\n
sudo yum update -y<\/p>\n
Once your system is updated, restart the system to apply all the changes.<\/p>\n
Install LAMP Server<\/h2>\n
Neos runs on a web server, is written in PHP and uses MariaDB to store its data. So you will need to install LAMP server on your system.<\/p>\n
First, install Apache web server using the following command:<\/p>\n
sudo yum install httpd -y<\/p>\n
Next, start Apache web server and enable it to start at boot time using the following command:<\/p>\n
sudo systemctl start httpd
sudo systemctl enable httpd<\/p>\nBy default, the latest version of the MariaDB is not available in CentOS 7. so you will need to install MariaDB repository to your system.<\/p>\n
You can add the MariaDB repository with the following command:<\/p>\n
curl -sS https:\/\/downloads.mariadb.com\/MariaDB\/mariadb_repo_setup | sudo bash<\/p>\n
Next, install MariaDB by running the following command:<\/p>\n
sudo yum install MariaDB-server MariaDB-client -y<\/p>\n
Once MariaDB is installed, start MariaDB service and enable it to start on boot using the following command:<\/p>\n
sudo systemctl start mariadb
sudo systemctl enable mariadb<\/p>\nNeos works on any version of PHP greater than 7.0. By default, PHP 7 is not included in CentOS 7 default repository. So you will need to add EPEL and Webtatic repository in your system.<\/p>\n
You can install EPEL and Webtatic repository using the following command:<\/p>\n
sudo yum install epel-release -y
sudo rpm -Uvh https:\/\/mirror.webtatic.com\/yum\/el7\/webtatic-release.rpm<\/p>\nNext, install PHP7.0 with other required libraries using the following command:<\/p>\n
sudo yum install php71w php71w-mbstring php71w-pdo_mysql php71w-cli php71w-tokenizer php71w-pecl-imagick php71w-xml php71w-pecl-imagick php71w-mcrypt php71w-opcache php71w-imap php71w-process php71w-intl -y<\/p>\n
Once all the packages are installed, you can check the version of the PHP using the following command:<\/p>\n
php -v<\/p>\n
You should see the following output:<\/p>\n
PHP 7.1.5 (cli) (built: May 12 2017 21:54:58) ( NTS ) \nCopyright (c) 1997-2017 The PHP Group \nZend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies \n<\/pre>\n
Next, you will need to make some changes inside php.ini file. You can do this by running the following command:<\/p>\n
sudo nano \/etc\/php.ini<\/p>\n
Make the following changes:<\/p>\n
date.timezone = Asia\/Kolkata \nmemory_limit = 250M \nxdebug.max_nesting_level = 500 \n<\/pre>\n
Save and close the file, when you are finished.<\/p>\n
Configure the Database<\/h2>\n
By default, MariaDB is not secured, so you will need to secure it first. You can do this by running the mysql_secure_installation script. This script will set a root password, remove an anonymous user, disallow root login and remove test database:<\/p>\n
sudo mysql_secure_installation<\/p>\n
Answer all the questions as follows:<\/p>\n
Enter current password for root (enter for none): Just press the Enter button \nSet root password? [Y\/n]: Y \nNew password: your-MariaDB-root-password \nRe-enter new password: your-MariaDB-root-password \nRemove anonymous users? [Y\/n]: Y \nDisallow root login remotely? [Y\/n]: Y \nRemove test database and access to it? [Y\/n]: Y \nReload privilege tables now? [Y\/n]: Y \n<\/pre>\n
Once the MariaDB is secured, log in to MariaDB console and create a database for Neos:<\/p>\n
mysql -u root -p<\/p>\n
Enter your root password, then create a database using the following command:<\/p>\n
MariaDB [(none)]>CREATE DATABASE neosdb;<\/p>\n
Next, create a username and password for Neos with the following command:<\/p>\n
MariaDB [(none)]>CREATE USER ‘neosuser’@’localhost’ IDENTIFIED BY ‘password’;<\/p>\n
Next, grant privileges to the Neos database with the following command:<\/p>\n
MariaDB [(none)]>GRANT ALL PRIVILEGES ON neosdb.* TO ‘neosuser’@’localhost’;<\/p>\n
Now change the character set of your database to utf8 using following query.<\/p>\n
MariaDB [(none)]>GALTER DATABASE neos_data charset=utf8;<\/p>\n
Next, flush the privileges with the following command:<\/p>\n
MariaDB [(none)]>flush privileges;<\/p>\n
Finally close the MySQL console:<\/p>\n
MariaDB [(none)]>exit;<\/p>\n
Once MariaDB is configured, you can proceed to install Neos.<\/p>\n
Install Neos\u00a0CMS<\/h2>\n
Before installing Neos, you will need to install Composer to your system. The Composer is a dependency manager for PHP. You can install it by running the following command:<\/p>\n
curl -sS https:\/\/getcomposer.org\/installer | php
sudo mv composer.phar \/usr\/bin\/composer<\/p>\nNext, change the directory to the Apache web root directory and download Neos with the following command:<\/p>\n
cd \/var\/www\/html
sudo composer create-project –no-dev neos\/neos-base-distribution neos<\/p>\nAbove command will download the Neos with all required dependencies.<\/p>\n
Next, give proper permissions to the neos directory:<\/p>\n
sudo choen -R apache:apache \/var\/www\/html\/neos
sudo chmod -R 777 \/var\/www\/html\/neos<\/p>\nNext, you will need to create a Virtual host for Neos. You can do this by running the following command:<\/p>\n
sudo nano \/etc\/httpd\/conf.d\/neos.conf<\/p>\n
Add the following lines:<\/p>\n
<VirtualHost *:80> ServerAdmin [email\u00a0protected]<\/a> DocumentRoot \"\/var\/www\/html\/neos\/Web\" ServerName example.com ServerAlias www.example.com <Directory \"\/var\/www\/html\/neos\/Web\"> Options Indexes FollowSymLinks AllowOverride All Order allow,deny Allow from all Require all granted <\/Directory> ErrorLog \"\/var\/log\/httpd\/neos-error_log\" CustomLog \"\/var\/log\/httpd\/neos-access_log\" combined \n<\/VirtualHost> \n<\/pre>\n
Save and close the file, then restart Apache service to apply these changes:<\/p>\n
sudo systemctl restart httpd<\/p>\n
Access Neos Web Installation Wizard<\/h2>\n
Before accessing Neos web interface, you will need to allow http and https service for outside access. You can do this by running the following command:<\/p>\n
sudo firewall-cmd –zone=public –permanent –add-service=http
sudo firewall-cmd –zone=public –permanent –add-service=https<\/p>\nFinally, reload the firewalld to apply all the changes:<\/p>\n
sudo firewall-cmd –reload<\/p>\n
Now, open your web browser and type the URL http:\/\/example.com, you will be redirected to the setup page as shown below:<\/p>\n
![\"Neos](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7.png\" "\\"\\"")
<\/a><\/p>\nYou will be asked to enter setup password, you can obtain the setup password by running the following command:<\/p>\n
cat \/var\/www\/html\/neos\/Data\/SetupPassword.txt<\/p>\n
You should see the setup password as shown below:<\/p>\n
The setup password is: MLGJHlj6apttd you successfully logged in, this file is automatically deleted for security reasons. \nMake sure to save the setup password for later use. \n<\/pre>\n
Enter the above password in the web interface, then click on the Login button, you should see the following page:<\/p>\n
![\"Neos](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-1.png\" "\\"\\"")
<\/a><\/p>\nHere, make sure that the imagick or gmagick PHP extension has been installed and chosen. Then click on the Next button, you should see the following page:<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-2.png\" "\\"\\"")
<\/a><\/p>\nHere, enter Database username and password which you have created earlier, select database drive, then click on the Next button, you should see the following page:<\/p>\n
![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-3.png\" "\\"\\"")
<\/a><\/p>\nHere, enter your administrator account detail, then click on the Next button, you should see the following page:<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-4.png\" "\\"\\"")
<\/a><\/p>\nHere, enter the site name as you wish, then click on the Next button to start the installation. Once the installation is finished, you should see the following page:<\/p>\n
![\"Neos](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-5.png\" "\\"\\"")
<\/a><\/p>\nNow, click on Go to backend button, you will be redirected to the Neos CMS login page as shown below:<\/p>\n
![\"Neos](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-6.png\" "\\"\\"")
<\/a><\/p>\n![\"Neos](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-neos-cms-on-centos-7-7.png\" "\\"\\"")
<\/a><\/p>\n