Help Portal

Installation Guide for IPMonitor ​

Installing IPMonitor is designed to be straightforward and user-friendly. This guide will walk you through the process of setting up IPMonitor on your server, from initial preparation to completion.

Step-by-Step Installation Video Guide for IPMonitor ​

In this six-minute video, we provide a detailed walkthrough of the IPMonitor installation process. From downloading the necessary files to configuring your server settings, we cover every crucial step to ensure a seamless setup. This guide is crafted to demystify the installation procedure, making it accessible for users of all skill levels. Watch closely as we share best practices and essential tips to get IPMonitor up and running on your server efficiently.

Open Video in Separate Window

Preparing Your Server ​

  1. Initiate a VM or Bare Metal Server: Ensure that you have a Virtual Machine (VM) or a bare-metal server ready.
  2. Install Operating System: Make sure that Ubuntu server, or a similar Linux distribution, is installed on your server.
  3. Upload License File: Transfer the license.dat file, which you've downloaded from the IPMonitor client area, to the user directory on the server.

Domain Setup ​

Assign a domain or a subdomain to point to your server's IP address. For instance, if your server's public IP address is 123.123.123.123, you can set a DNS record like:

ipmonitor.mydomain.com A 123.123.123.123
ipmonitor.mydomain.com A 123.123.123.123

Installing IPMonitor ​

  1. Update System Packages:

    sudo apt update
sudo apt upgrade -y
    sudo apt update
sudo apt upgrade -y

  2. Install Dependencies:

    sudo apt install -y curl git make
    sudo apt install -y curl git make

  3. Download and Run Installer:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/octeth/ipmonitor-install/master/installer.sh)"
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/octeth/ipmonitor-install/master/installer.sh)"

    During installation, you will be prompted to provide:

    • Email Address for the First User
    • Domain Name for SSL Certificate
    • Full Path to the License File
    • First User Name
    • First User Password

    Follow the prompts and input the necessary information.

Optional: SSL Certificate Generation ​

It's highly recommended to generate an SSL certificate for the domain pointed to your server. Follow the on-screen instructions provided during the installation process to complete this step.

Finalizing Installation ​

After providing all required information, the installer will complete the setup process. Follow any additional on-screen instructions to finalize the installation of IPMonitor.

Uninstalling IPMonitor ​

If you need to uninstall IPMonitor from your server, please follow these steps:

Execute Cleanup Command:

cd /opt/ipmonitor && ./cleanup.sh
cd /opt/ipmonitor && ./cleanup.sh

Before uninstalling, ensure that you have backed up any important data.