web analytics
Skip to content

How to Install Logic Invoice on OpenShift

    Logic Invoice-OpenShift-logo

    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.


    1. A free OpenShift account, visit OpenShift website and register using your email, no credit card is required. 1 - create openshift account


    1. After registering; go to OpenShift home page and click on the “MY APPS” on the top of the screen.2 - open Openshift Account
    2. 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.3-create openshift application
    3. You’ll be directed to a new window, type “PHP, MySQL” in the search field, and select the application shown below in the screenshot. 2 - concrete5 on openshift
    4. 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.5 - openshift application name
    5. Under the public URL, there’s the source code field, just leave it empty.
    6. Leave everything as it’s and click on “Create Application” tab at the end of the page.3 - concrete5 on openshift
    7. You shall be directed to a new window where you shall find all of your “MySQL” credentials.4 - concrete5 on openshift
    8. 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).
    9. 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”.2 - Logic Invoice on Openshift
    10. 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”.3 - Logic Invoice on Openshift
    11. Then you have to unzip the downloaded file, to do so type “unzip Lo*”.4 - Logic Invoice on Openshift
    12. 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.5 - Logic Invoice on Openshift
    13. 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.6 - Logic Invoice on Openshift
    14. 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.7 - Logic Invoice on Openshift
    15. 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”.8 - Logic Invoice on Openshift
    16. 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.
    17. A new window will pop-up just copy the number shown in the below screenshot. 6 - thinkup database host
    18. 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.
    19. Then you’ll be directed to a new window where you should click the green “remove installation folder” tab.9 - Logic Invoice on Openshift
    20. 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.

    11 - Logic Invoice on Openshift

    Congratulations, now you have a fully functional Logic Invoice portal running for free on OpenShift.