Installing a Netris Controller on Equinix Metal on-demand server

Installation Steps

You can install the Netris controller almost on any 64-bit Linux host. You can use a single Netris controller for operating multiple sites (regions).

Request a server

The smallest flavor, c3.small.x86, is enough for most users.

../_images/equinix-request-c3-small-server.png

if you decide to use a VM, please see below the minimal VM requirements.

  • RAM: 8 GB

  • CPU: 4 Cores

  • Disk: 50GB

  • OS: Linux 64-bit

DNS record

In my example my host got a public IP address 139.178.89.255. While it is OK for users and nodes to refer to the Netris Controller through an IP address, we recommend using a DNS record (this way it will be easier to potentially move Netris Controller somewhere with a different IP address).

Below is example using Cloudflare DNS service. (same idea with any DNS software or service)

../_images/dns-cloudflare-equinix-ip.png

Ensure that newly created domain name indeed resolves into the right IP address of the machine that you are going to install the Netris Controller.

host netrisctl.netris.dev
netrisctl.netris.dev has address 139.178.89.255

Install Netris Controller software and dependencies

curl -sfL https://get.netris.io | sh -s -- --ctl-hostname netris.example.com --ctl-ssl-issuer letsencrypt

Note

Netris Controller installer will stand up a K3S cluster and then will deploy Netris Controller on top of it using Helm Chart. The “–ctl-ssl-issuer” will instruct the installer to generate a Let’s Encrypt SSL certificate and the “–ctl-hostname” will hint for what domain name the certificate must be generated. That’s why it is important to create the DNS record before this step. Detailed info here: doc.

../_images/netris-controller-installed.png

Once installation process is finished you will be able to access your newly installed Netris Controller web console using netris/newNet0ps credentials.

Security Matters

Change the default password

Setting → My Account → Change Password

../_images/change-password.png

Add new admin user

Accounts → Users → +Add

../_images/create-new-admin-user.png