1. Server Setup

If the recommended simplified installation method isn't an option, this guide will show the procedure to install FaxStore and it's dependencies manually. This guide will go through the installation of the LEMN stack along with configuring FaxStore.

Before Starting

Make sure an A record has been created for the chosen domain and that it points to the server’s public IP address. Correct DNS setup is important so Nginx and SSL configuration can complete properly during installation.
Have an SSH application (like Termius) and SFTP application (like WinSCP) ready to be used
Ensure all of FaxStore's prerequisites are met
Know the server's login details

Installing FaxStore APT Dependencies

Update the server and installed the required content on to the server using the below commands

Update the servers package repository

apt-get -y update

Install the required items through the package manager

apt-get install nginx mysql-server certbot python3-certbot-nginx -y

This may take some time, a prompt to select yes or no is likely to appear during installation.

Install NVM & Node.js

Install Node and Node Version Manager by using the below commands, FaxStore requires a specific version of Node.js to operate, currently it's 20.5.1

Install NVM

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

Restart the terminal application to register the new commands
Verify NVM has been installed

nvm -v

Install the required Node version by using the NVM install command

nvm install 20.5.1

MySQL Configuration

It's recommended to complete the MySQL server configuration before using it to ensure it meets desired requirements and is secure.

Run the configuration command to begin, this will ask a series of questions to be responded too. For FaxStore's security it's recommended to not allow remote connections.

sudo mysql_secure_installation

Set the MySQL Password

sudo mysql

Alter the user to set the password

Be sure to replace the CHANGE_ME text to the desired password.

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'CHANGE_ME';

Reload the MySQL servers permissions, known as flushing

FLUSH PRIVILEGES;

Exit the MySQL server console

exit

MySQL is now setup and functional.