Logic Invoice is a free self-hosted web application for creating invoices, so if you are the founder of a startup or a small business owner searching for a free invoicing solution then this post is for the rescue.
This guide will present a step by step tutorial on how to install Logic Invoice on OpenShift, the only skill you’ll need during the tutorial is your ability to use a web browser. Before Starting this guide assumes that you already know how to use KeyBox with OpenShift, if you don’t then head to this post “SSH to Your OpenShift Applications From the Browser” to know how to use it.
- A free OpenShift account, visit OpenShift website and register using your email, no credit card is required.
- After registering; go to OpenShift home page and click on the “MY APPS” on the top of the screen.
- You’ll be directed to your log-in window just enter your credentials, you’ll then be directed to a new window click on the blue “Create your first application now” link.
- You’ll be directed to a new window, type “PHP, MySQL” in the search field, and select the application shown below in the screenshot.
- You’ll be directed to a new window, in the public URL; type the name of the project/application name (e.g. InvoicePortal, LogicInvoice, etc.) in the first space and the domain name (it’s not your real domain name, just any identification name e.g. NickName, YourName) in the second space.
- Under the public URL, there’s the source code field, just leave it empty.
- Leave everything as it’s and click on “Create Application” tab at the end of the page.
- You shall be directed to a new window where you shall find all of your “MySQL” credentials.
- You’ll then be directed to the main window and it’s time to go to your ” website” and start the installation process, to do that simply click on the blue link at the top of the screen (that’s your URL).
- Before starting the installation process of Logic Invoice, you have to download and unzip it and to do that we’ll use KeyBox, so log into your KeyBox account and use it to log into your Logic Invoice application. in the command line type “cd app-root/repo”.
- Then you have to download Logic Invoice by typing the following command “wget https://github.com/Equotix/Logic-Invoice/releases/download/v1.2.0/Logic-Invoice-1.2.0.zip”.
- Then you have to unzip the downloaded file, to do so type “unzip Lo*”.
- Now we need to move the content of the folder “upload” from it to the main repo folder to do that type the following command “mv /upload/* /var/lib/openshift/number_of_you_application/app-root/repo” of course you’ve to replace number_of_your_application with your application number either from the link to your application page “ssh://number” or from KeyBox.
- Now you can click on the blue link from step 8 and you’ll be directed to a new window where you can start the installation process. In the first window just click on the “I have read and agree to the license” tab.
- You’ll then be directed to a window where the Logic Invoice installation process will check for the installation requirements, just click on the “continue” tab.
- You’ll then be directed to a new window, where you should enter some information like “password, database username, database password”, you can get this information from step “7”.
- In that window, in which you should provide your database credentials, there’s a small trick; which is getting your database Hostname, the easiest way to do so is to return to your application and click on the small arrow at the phpMyAdmin tab.
- A new window will pop-up just copy the number shown in the below screenshot.
- Paste that number in the database hostname field in the Logic Invoice installation, then fill in the rest of the information from your database credentials that you can find in your application, then click next.
- Then you’ll be directed to a new window where you should click the green “remove installation folder” tab.
- You’ll then be redirected to the backend (admin panel, use the admin username and password you’ve created in step 15 to log in) of your portal, where you can control every aspect of your portal with a simple GUI.
Congratulations, now you have a fully functional Logic Invoice portal running for free on OpenShift.