Everything you need to know about NexoPOS.
Before considering installing NexoPOS 4.x, a proper environment should be setup. There are many solutions that can be used to host NexoPOS such as local hosting and remote hosting. However, the most important when you must determine the location of the environment is to consider what operating system will be used. This guide will cover :
NexoPOS 4.x requires PHP 8.0, so the first thing to install is apache with PHP 8.0. Whether you're using Ubuntu 20.04 locally or remotely, the installation will be made from the CLI (Command Line Interface). If you would like to know how to install and configure PHP 8.0 on Ubuntu, this tutorial covert it.
We'll need to install a database manager and a graphical interface for managing databases such as PhpMyAdmin.
There are many tutorials online that are well made for this purpose. We suggest the tutorial written on Digital Ocean.
Composer is required to install NexoPOS 4.x, even if you want to install using Github. The installation of Composer is simple. The documentation of Composer explains how you should proceed to install it on Ubuntu. But you can follow these instructions to download and install Composer on your system.
Let's first update the package manager :
sudo apt update
We'll now switch to the home directory and download composer.
cd ~ curl -sS https://getcomposer.org/installer -o composer-setup.php
Let's now install Composer globally so that we can use the shortcut "composer" on the CLI :
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
So now by typing "composer" on your CLI, you should have a similar output.
______ / ____/___ ____ ___ ____ ____ ________ _____ / / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/ / /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ / \____/\____/_/ /_/ /_/ .___/\____/____/\___/_/ /_/ Composer version 2.3.5 2022-04-13 16:43:00 Usage: command [options] [arguments] Options: -h, --help Display help for the given command. When no command is given display help for the list command -q, --quiet Do not output any message -V, --version Display this application version --ansi|--no-ansi Force (or disable --no-ansi) ANSI output -n, --no-interaction Do not ask any interactive question --profile Display timing and memory usage information --no-plugins Whether to disable plugins. --no-scripts Skips the execution of all scripts defined in composer.json file. -d, --working-dir=WORKING-DIR If specified, use the given directory as working directory. --no-cache Prevent use of the cache -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
This step might not be required in the near future as NexoPOS will very soon be released with the assets built. However, this step might be useful for those willing to contribute. Here, the guys from techadmin have a mode detailed guide that will be helpful for you.
Supervisor is an application that will help NexoPOS 4.x running jobs behind the scene. As we have previously mentioned NexoPOS 4.x has background processes that need to be executed. The installation of Supervisor is covered on Laravel documentation, however, for convenience, we'll provide the steps here.
sudo apt-get install supervisor
Then you'll need to configure Supervisor in order to make it point to your NexoPOS 4.x installation.
[program:nexopos-worker] process_name=%(program_name)s_%(process_num)02d command=php /var/www/html/nexopos-4x/artisan queue:work --sleep=3 --tries=3 --max-time=3600 autostart=true autorestart=true user=forge numprocs=8 redirect_stderr=true stdout_logfile=/var/www/html/nexopos-4x/worker.log stopwaitsecs=3600
We assume here you plan to install NexoPOS on the directory : /var/www/html/nexopos-4x.
Consider reading the Laravel documentation for further instructions.
Regarding Windows configuration, the steps are pretty simple. You just need to install Laragon. It already comes with NodeJs, composer, phpMyAdmin, and many other utilities.
The only thing required is to make sure to configure "Scheduled Tasks" to execute on the directory where NexoPOS 4.x is installed. If on Windows you're using WSL, then the above guide for Ubuntu applies.