Virtual Machine Installation


Minimal system requirements for the VM:

  • CPU - 4 Core

  • RAM - 4 Gb

  • Disk - 100Gb

  • Network - 1 virtual NIC

Recommended system requirements for the VM:

  • CPU - 8 Core

  • RAM - 16 Gb

  • Disk - 100Gb

  • Network - 1 virtual NIC

KVM Hypervisor Installation

If KVM is not already installed, install Qemu/KVM on the host machine (example provided for Ubuntu Linux 18.04)

sudo apt-get install virt-manager

VM Controller Installation

  1. Download the Netris Controller image. (contact Netris support for repository access permissions).

cd /var/lib/libvirt/images

sudo wget
  1. Download VM definition file.

cd /etc/libvirt/qemu

sudo wget
  1. Define the KVM virtual machine

sudo virsh define netris-controller3.xml


Netris Controller virtual NIC will bind to the “br-mgmt” interface on the KVM host machine. See below for the network interface configuration example.

Example: Network configuration on host (hypervisor) machine.


replace <Physical NIC>, <host server management IP/prefix length> and <host server default gateway> with the correct NIC and IP for your host machine.

sudo vim /etc/network/interfaces
#Physical NIC connected to the management network
auto <Physical NIC>
iface <Physical NIC> inet static

#bridge interface
auto br-mgmt
iface br-mgmt inet static
                        address <host server management IP/prefix length>
                        gateway <host server default gateway>
                        bridge-ports <Physical NIC>

source /etc/network/interfaces.d/*
sudo ifreload -a
  1. Set the virtual machine to autostart and start it.

sudo virsh autostart netris-controller
sudo virsh start netris-controller

Accessing the Netris Controller

By default, Netris Controller will obtain an IP address from a DHCP server.

Below steps describe how to configure a Static IP address for the Netris Controller.

  1. Connecting to the VM console.

default credentials. login: netris password: newNet0ps

sudo virsh console netris-controller


Do not forget to change the default password (using passwd command).

  1. Setting a static IP address.

Edit network configuration file.

sudo vim /etc/network/interfaces

Example: IP configuration file.

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
        address <Netris Controller IP/prefix length>
        gateway <Netris Controller default gateway>
        dns-nameserver <a DNS server address>

source /etc/network/interfaces.d/*

Reload the network config.

sudo ifreload -a


Make sure Netris Controller has Internet access.

  1. Reboot the controller

sudo reboot

After reboot, the Netris Controller GUI should be accessible using a browser. Use netris/newNet0ps credentials.

Netris Credentials

Replacing the SSL certificate

  1. Replace the below file with your SSL certificate file.

  1. Replace the below file with your SSL private key.

  1. Restart Nginx service.

systemctl restart nginx.service