Standalone Installation

Instructions for installing the application in a standalone environment

1. Installation using PM2 (recommended)

Prerequisites

Before you begin, ensure you have the following installed on your server or local machine:

• Node.js (includes npm)
• npm (Node Package Manager)
• PM2

Installation Steps

1. Get the latest release

   Download the latest release of the application from our GitHub releases page.

   You can also use the following command to download the latest release directly to your server:

   wget https://github.com/localineapp/web-app/releases/latest/download/localineapp.tar.gz
   
2. Extract the downloaded file

   Once the download is complete, extract the contents of the tarball:

   tar -xzf localineapp.tar.gz
   
3. Install dependencies

   Install the necessary dependencies using npm:

   npm install --production
   
4. Build the application

   Build the application using npm:

   npm run build
   
5. Start the application with PM2

   Start the application using PM2:

   pm2 start npm --name "localineapp" -- run start
   

   This command will start the application and keep it running in the background. You can check the status of your application with:

   pm2 status
   
6. Set up PM2 to start on boot (optional)

   To ensure that your application starts automatically when the server reboots, set up PM2 to start on boot:

   pm2 startup
   pm2 save
   

   Follow the instructions provided by the command to complete the setup.

---

2. Installation using Screen (not recommended)

Prerequisites

Before you begin, ensure you have the following installed on your server or local machine:

• Node.js (includes npm)
• npm (Node Package Manager)
• Screen

Installation Steps

1. Get the latest release

   Download the latest release of the application from our GitHub releases page.

   You can also use the following command to download the latest release directly to your server:

   wget https://github.com/localineapp/web-app/releases/latest/download/localineapp.tar.gz
   
2. Extract the downloaded file

   Once the download is complete, extract the contents of the tarball:

   tar -xzf localineapp.tar.gz
   
3. Install dependencies

   Install the necessary dependencies using npm:

   npm ci
   
4. Build the application

   Build the application using npm:

   npm run build
   
5. Start the application with Screen

   Start a new Screen session:

   screen -S localineapp
   

   Then, start the application:

   npm run start
   

   To detach from the Screen session and keep it running in the background, press Ctrl + A, then D. You can reattach to the session later with:

   screen -r localineapp
   

   To stop the application, reattach to the Screen session and press Ctrl + C.