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. Once this file is downloaded, follow the instructions below to install and run the application.

Please submit bugs and error reports [here]( Please find the list of bugs we are looking into [here](

Disclaimer: 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.

Use the dpkg package manager to install the deb file from your terminal.
sudo dpkg -i <path to deb file>
Start the application from your terminal.

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.