Installing dependencies (logviewer)

As this page involves editing security rules, please follow the instructions below. Failure to do so may expose your VPS to security vulnerabilities.

Amending subnet rules

Start by going to your instance's page on Oracle. Scroll down to Instance details and click on your Virtual cloud network.

Go to Subnets and click on your subnet.

Go to Security and click on your security list.

Click on Security rules and click on Add Ingress Rules.

Fill in the following:

Source Type: CIDR Source CIDR: 0.0.0.0/0 IP Protocol: TCP Source Port Range: Blank Destination Port Range: 8000 (if you are planning on hosting logviewer on a different port, change this to the port of your choice.) Description: Blank

Click on Add Ingress Rules to save your changes.

Now move over to your VPS in order to install additional dependencies.

Python 3.9

Logviewer needs Python 3.9 in order to run. Don't worry as pipenv automatically detects which Python version to use and this won't interfere with your Modmail installation.

Begin by adding the deadsnakes ppa:

sudo add-apt-repository ppa:deadsnakes/ppa

Install Python 3.9 and its distutils:

sudo apt install python3.9 python3.9-distutils

Amending iptables rules.

iptables will prevent your public IP from being accessed. Solve this by running:

sudo iptables -I INPUT -j ACCEPT

Save this change permanently by doing the following:

First of all, switch to the root account by running:

sudo su

Save the iptables change by running:

iptables-save > /etc/iptables/rules.v4

Exit from the root account by running:

exit

PM2

If you installed PM2 during Installing dependencies, you may skip this step

If you're not planning on using PM2, skip this section. PM2 is required for keeping your logviewer alive 24/7.

Start by installing node.js and npm:

sudo apt install nodejs npm

npm depends on a considerable amount of packages. Expect this to take some time.

Install pm2 by running:

sudo npm i -g pm2