- \n
- WebServer (Apache, NGINX).\u00a0This tutorial will use Nginx.<\/li>\n
- MySQL\u00a0version 5.5 or greater or the equivalent version of MariaDB.<\/li>\n
- PHP version 7.0 or greater with the following PHP extensions installed and activated:<\/li>\n
php-gd<\/code><\/li>\nphp-hash<\/code><\/li>\nphp-json<\/code><\/li>\nphp-mbstring<\/code><\/li>\nphp-mcrypt<\/code><\/li>\nphp-mysqli<\/code><\/li>\nphp-openssl<\/code><\/li>\nphp-recode<\/code><\/li>\nphp-xmlrpc<\/code><\/li>\nphp-zlib<\/code><\/li>\n<\/ul>\n- \n
- A server running\u00a0CentOS 7.<\/li>\n
- A non-root user with sudo privileges.<\/li>\n<\/ul>\n
Initial steps<\/h2>\n
Check\u00a0your CentOS system version:<\/p>\n
cat \/etc\/centos-release\n# CentOS Linux release 7.6.1810 (Core)<\/code><\/pre>\nSet up the timezone:<\/p>\n
timedatectl list-timezones\nsudo timedatectl set-timezone 'Region\/City'<\/code><\/pre>\nUpdate your operating system\u2019s packages:<\/p>\n
sudo yum update\u00a0-y<\/code><\/pre>\nInstall\u00a0required packages:<\/p>\n
sudo yum install -y vim wget curl git bash-completion unzip<\/code><\/pre>\nStep 1 –\u00a0Install PHP and required PHP extensions<\/h2>\n
InovicePlane\u00a0web application requires PHP version\u00a07.0.0\u00a0or greater. Default CentOS repositories contain older version of PHP, and thus we will need to set up a third-party repository to install a newer PHP version. We will use Webtatic repository.<\/p>\n
Setup the Webtatic YUM repo:<\/p>\n
sudo rpm -Uvh https:\/\/mirror.webtatic.com\/yum\/el7\/webtatic-release.rpm<\/code><\/pre>\nInstall PHP, as well as the necessary PHP extensions:<\/p>\n
sudo yum install -y php72w php72w-cli php72w-fpm php72w-common php72w-gd php72w-json php72w-mbstring php72w-mcrypt php72w-mysql php72w-xmlrpc php72w-recode<\/code><\/pre>\nCheck the PHP version:<\/p>\n
php --version<\/code><\/pre>\n#\u00a0PHP 7.2.12 (cli) (built: Nov\u00a011 2018 14:54:16) ( NTS )
\n# Copyright (c) 1997-2018 The PHP Group
\n#\u00a0Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies<\/p>\n<\/code><\/pre>\nStart and enable PHP-FPM service:<\/p>\n
sudo systemctl start php-fpm.service\nsudo systemctl enable php-fpm.service<\/code><\/pre>\nStep 2 – Install MariaDB<\/h2>\n
Install MariaDB database server:<\/p>\n
sudo yum install -y mariadb-server<\/code><\/pre>\nCheck the MariaDB version:<\/p>\n
mysql --version\n# mysql Ver 15.1 Distrib 5.5.60-MariaDB, for Linux (x86_64) using readline 5.1<\/code><\/pre>\nStart and enable MariaDB service:<\/p>\n
sudo systemctl start mariadb.service\nsudo systemctl enable mariadb.service<\/code><\/pre>\nRun\u00a0
mysql_secure installation<\/code>\u00a0script to improve MariaDB security and set the password for MariaDB\u00a0root<\/code>\u00a0user:<\/p>\nsudo mysql_secure_installation<\/code><\/pre>\nAnswer all the questions as shown below:<\/p>\n
Enter current password for root (enter for none):\nSet root password? [Y\/n]: Y\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<\/code><\/code><\/pre>\nLog into MariaDB shell as the user root:<\/p>\n
mysql -u root -p\n# Enter password<\/code><\/pre>\nCreate a MariaDB database and user that you will use for your installation of InvoicePlane, and remember the credentials:<\/p>\n
CREATE DATABASE dbname;\nGRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';\nFLUSH PRIVILEGES;<\/code><\/pre>\nExit from MariaDB shell:<\/p>\n
quit<\/code><\/pre>\nStep 3 – Install NGINX<\/h2>\n
Install Nginx web server:<\/p>\n
sudo yum install -y nginx<\/code><\/pre>\nCheck the NGINX version:<\/p>\n
nginx -v\n# nginx version: nginx\/1.12.2<\/code><\/pre>\nStart and enable Nginx service:<\/p>\n
sudo systemctl start nginx.service\nsudo systemctl enable nginx.service<\/code><\/pre>\nConfigure\u00a0NGINX for InvoicePlane. Run\u00a0
sudo vim \/etc\/nginx\/conf.d\/invoiceplane.conf<\/code>\u00a0and populate the file with the following configuration:<\/p>\nserver {\n listen 80;\n listen [::]:80;\n\n server_name example.com;\n\n root \/var\/www\/invoiceplane;\n\n index index.php index.html;\n\n location \/ {\n try_files $uri $uri\/ \/index.php?$query_string;\n }\n\n location ~ \\.php$ {\n fastcgi_index index.php;\n try_files $uri =404;\n include fastcgi_params;\n fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n fastcgi_pass 127.0.0.1:9000;\n }\n}\n<\/code><\/pre>\nTest the NGINX configuration:<\/p>\n
sudo nginx -t<\/code><\/pre>\nReload NGINX:<\/p>\n
sudo systemctl reload nginx.service<\/code><\/pre>\nStep 4 – Install InvoicePlane<\/h2>\n
Download the latest stable version of InvoicePlane and extract the archive:<\/p>\n
sudo mkdir -p \/var\/www\ncd \/var\/www\nsudo curl -O -J -L https:\/\/invoiceplane.com\/download\/v1.5.9\nsudo unzip v1.5.9.zip\nsudo rm v1.5.9.zip\nsudo mv ip invoiceplane<\/code><\/pre>\nNavigate to\u00a0
\/var\/www\/invoiceplane<\/code>\u00a0folder:<\/p>\ncd \/var\/www\/invoiceplane<\/code><\/pre>\nMake a copy of the\u00a0
ipconfig.php.example<\/code>\u00a0file and rename the copy to\u00a0ipconfig.php:<\/code><\/p>\nsudo cp ipconfig.php.example ipconfig.php<\/pre>\n
Open the\u00a0
ipconfig.php<\/code>\u00a0file and add your URL in it:<\/p>\nsudo vim ipconfig.php\n# Something like this\nIP_URL=http:\/\/example.com<\/pre>\n
Change ownership of the\u00a0
\/var\/www\/invoiceplane<\/code>\u00a0directory to\u00a0nginx:<\/code><\/p>\nsudo chown -R nginx:nginx \/var\/www\/invoiceplane<\/code><\/pre>\nRun\u00a0
sudo vim \/etc\/php-fpm.d\/www.conf<\/code>\u00a0and set the user and group to\u00a0nginx<\/code>. Initially, they will be set to\u00a0apache:<\/code><\/p>\nsudo vim \/etc\/php-fpm.d\/www.conf\n# user = nginx\n# group = nginx<\/code><\/pre>\nRun\u00a0
sudo vim \/etc\/php.ini<\/code>\u00a0and set\u00a0date.timezone:<\/code><\/p>\ndate.timezone = Region\/City<\/pre>\n
Restart the PHP-FPM service:<\/p>\n
sudo systemctl restart php-fpm.service<\/code><\/pre>\nRun the InvoicePlane installer from your web browser and follow the instructions:<\/p>\n
http:\/\/example.com\/index.php\/setup<\/code><\/pre>\nOnce the installation has finished, you may log into InvoicePlane using the email address and password you have chosen during the installation.<\/p>\n
If you want to secure your installation, you may disable the setup. To do so, replace the line\u00a0
DISABLE_SETUP=false<\/code>\u00a0with\u00a0DISABLE_SETUP=true<\/code>\u00a0in your\u00a0ipconfig.php<\/code>\u00a0file.<\/p>\nStep 5 – Complete the\u00a0InvoicePlane setup<\/h2>\n
InvoicePlane is now installed and configured, it’s time to access their web installation wizard.<\/p>\n
Open your web browser and type the URL http:\/\/example.com<\/strong>. You will be redirected to the following page:<\/p>\n
![\"InvoicePlane](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-invoiceplane-with-nginx-on-centos-7.png\" "\\"\\"")
<\/a><\/p>\nNow, click on the\u00a0Setup<\/strong>\u00a0button. You should see the following page:<\/p>\n
![\"Choose](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-invoiceplane-with-nginx-on-centos-7-8.png\" "\\"\\"")
<\/a><\/p>\nNext, choose the language and click on the\u00a0Continue<\/strong>\u00a0button. You should see the following page:<\/p>\n
![\"Prerequisite](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-invoiceplane-with-nginx-on-centos-7-9.png\" "\\"\\"")
<\/a><\/p>\nNext, click on the\u00a0Continue<\/strong>\u00a0button. You should see the following page:<\/p>\n
![\"Database](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-invoiceplane-with-nginx-on-centos-7-10.png\" "\\"\\"")
<\/a><\/p>\nHere, provide your database details and click on the\u00a0Try Again<\/strong>\u00a0button. You should see the following page:<\/p>\n
![\"Database](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-invoiceplane-with-nginx-on-centos-7-11.png\" "\\"\\"")
<\/a><\/p>\nNow, click on the\u00a0Continue<\/strong>\u00a0button. You should see the following page:<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-invoiceplane-with-nginx-on-centos-7-12.png\" "\\"\\"")
<\/a><\/p>\nNow, click on the\u00a0Continue<\/strong>\u00a0button. You should see the following page:<\/p>\n
![\"InvoicePlane](\"https:\/\/www.howtoforge.com\/images\/how_to_install_invoiceplane_on_centos_7\/big\/Screenshot_2018-12-09_at_21.39_.03_.png\" "\\"\\"")
<\/a><\/p>\n