X
    Categories: Tutorials

Install InvoicePlane on a CentOS VPS

InvoicePlane is a self-hosted open source application for invoices, clients, quotes and payments management. It is used by many companies and freelancers worldwide to manage their complete billing circle. We will show you how to install InvoicePlane on a Linux VPS.

First of all, connect to your server via SSH and upgrade all your system software to the latest version available.

yum update

The update will take few moments. After it completes, you are ready to proceed with the other steps of this tutorial. Navigate to the ‘/var/www/html’ directory on your server.

cd /var/www/html/

Create a directory for InvoicePlane.

mkdir invoiceplane

Navigate to the newly created direcory.

cd invoiceplane/

Now, download the latest version of InvoicePlane from the official website. The current version of InvoicePlane is v1.4.7, so we will download and install the current version.

wget https://invoiceplane.com/download/v1.4.7

Next, unzip the InvoicePlane zip archive.

unzip v1.4.7*

Navigate to the ‘/var/www/html’ directory.

cd /var/www/html/

Change the ownership of the InvoicePlane files and directories. The new owner should be your web server. If you are using Apache on your CentOS VPS you can use the following command to do that.

chown -R apache: invoiceplane/

Since InvoicePlane uses MySQL database in order to store its data, you need to create a new database. Go ahead and login to your MySQL database.

mysql -u root -p

To create a database, a database user and set up a password, enter the following commands one by one:

mysql> CREATE DATABASE invoiceplane;
mysql> GRANT ALL PRIVILEGES ON invoiceplane.* TO 'invoiceplane'@'localhost' IDENTIFIED BY 'YoUrPaSsWoRd';
mysql> FLUSH PRIVILEGES;
mysql> \q

Of course, you can use different database name, username and password for your installation.

The last thing you need to do before you move on to the online installation is to create a virtual host for InvoicePlane. Edit your ‘/etc/httpd/conf/httpd.conf’ file using a text editor of your choice. We are using nano.

nano /etc/httpd/conf/httpd.conf

Add the following lines:

<VirtualHost *:80>
 ServerAdmin admin@yourdomain.com
 DocumentRoot /var/www/html/invoiceplane
 ServerName yourdomain.com
 ServerAlias www.yourdomain.com
 <Directory /var/www/html/invoiceplane/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
 </Directory>
 ErrorLog /var/log/httpd/yourdomain.com-error_log
 CustomLog /var/log/httpd/yourdomain.com-access_log common
</VirtualHost>

Do not forget to replace yourdomain.com with your actual domain name. After you finish with the changes, save the file and close it. Restart your Apache web server so the changes can take effect.

If everything is done correctly, you are ready to continue with the online installation. Open your favorite web browser and navigate to

http://yourdomain.com/setup

The InvoicePlane setup screen will appear and you will need to choose a language so you can continue with the installation.

If you like to learn how to use InvoicePlane, our recommendation is to check the official InvoicePlane wiki at https://wiki.invoiceplane.com/en/1.0.

Of course you don’t have to do any of this if you use one of our Linux VPS hosting services, in which case you can simply ask our expert Linux admins to install InvoicePlane for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.