Deploy iNethi

To deploy an iNethi-based network, we recommend running a server with a fresh install of the Ubuntu 22 LTS server operating system, a pfSense/OPNsense firewall, a managed switch and access points of your choice. To learn more about setting up the network as a whole, read here. This installation guide will focus on the server installation process.

Please note that you can run the installer application on the machine that will run as the server, but it will need a desktop environment to do this. We highly recommend you run the installer from a machine on the same local area network (LAN) as the server. However, if you decide to run the installer on the server, please note that your server may reboot to apply updates. This will only happen once, so once it has happened, restart the installer application and follow the same onscreen prompts to finish the installation.

Install from the Prepackaged Application

To run the installer application on an Ubuntu system, download the deb file here* (choose the correct system architecture). Once this file is downloaded, follow the instructions below to install the application and run it.

* the x64 file will run on machines with AMD and Intel CPUs. If you are running Ubuntu on a Raspberry Pi or Mac with a silicon chip, then the arm build will work.

Disclaimer: While the Installer application will run on both x64 and ARM CPUs, the iNethi network is designed to run on systems with x64 architecture CPUs, such as those from Intel and AMD. It is not compatible with ARM architecture CPUs. Please ensure your system meets these requirements before installing.

  1. Use the dpkg package manager to install the deb file from your terminal.
    ```sudo dpkg -i <path to deb file>```
  2. Start the application from your terminal.
    ```inethi```
  3. Follow the onscreen instructions to set up your server.

Build and Run from Source

To build and run the code from source make sure you have NPM installed on your machine, then follow the instructions below:

  1. Clone the GitHub repo.
  2. Install dependencies using npm from the root directory of the repo.
    ```npm install```
  3. Start the application.
    ```npm start```
  4. Follow the on-screen instructions to build your server.