Installation
=====================================

Standard Packages
-------------------------------------

Standard install packages for Redhat and Ubuntu are the easiest method to install LQR since it: 

1. puts binaries in canonical Unix locations 

1. makes upgrades and uninstalls seamless

1. installs dependencies automatically

To donwload these packages, head to our repository page at https://www.vitorian.com/repo/lucisqr/latest/

.. image:: images/lqr_download.png

.. warning::
    You will not be able to use command line binaries like `curl` or `wget` to download the installer due to our web server anti-hacker protection mechanisms.
    Download using your normal web client as Firefox, Safari or Chrome and copy to your local Unix machine.

There you can find `*.deb` files for Ubuntu (Debian) and `*.rpm` packages for Redhat RHEL (CentOS,Fedora).

If you downloaded debian packaged files, install them with `dpkg` 

.. code-block:: bash
    
    $ sudo dpkg -i lightqr-ubuntu20.04-0.1.1-20220716.x86_64.deb

In Redhat systems use `rpm` instead:

.. code-block:: bash

    $ sudo rpm -i lightqr-centos7-0.1.1-20220716.x86_64.rpm

Online Installer
-------------------------------------

If your system does not accept any of these formats, give a try on the online installer. 

Download the file `installer.run` and copy the executable to a temporary folder. 

.. note::
    Remember to set the execute flags on this file with `chmod ug+rx installer.run`

Once the file is downloaded and the execute bit is set, run it with `./installer.run`. A welcome screen will be shown

.. image:: images/installer_start.png 

Next a screen will ask you for a destination folder. By default we use `/opt`

.. image:: images/installer_folder.png

Then enter the operating system files that you want to download. Note that only the files specific for the given OS will be downloaded. 

.. image:: images/installer_os.png

Accept the commercial license.

.. image:: images/installer_license.png

Then hit `Install`  for the download to begin

.. image:: images/installer_go.PNG

The download will begin, then followed by unpacking of the downloaded files

.. image:: images/installer_installing.png

And hopefully everything will come to an end

.. image:: images/installer_complete.PNG



.. note::
    Unlike the packaged versions, which are installed in the default system folders `/bin`, `/usr/bin` and `/usr/lib`, the default location for the binaries will be `/opt/lightqr-<version>` 

.. image:: images/installer_files.png